atoi, atol, atoll

来自cppreference.com
< c‎ | string‎ | byte
在标头 <stdlib.h> 定义
int       atoi( const char *str );
long      atol( const char *str );
long long atoll( const char *str );
(C99 起)

转译 str 所指的字节字符串中的整数值。隐含的基数总为 10。

舍弃任何空白符,直至找到首个非空白符,然后接收尽可能多的字符以组成合法的整数表示,并转换之为整数值。合法的整数值含下列部分:

  • (可选) 正或负号
  • 数位

如果结果的值无法被表示,即转换后的值落在对应返回类型之外,则其行为未定义。

参数

str - 指向要转译的空终止字符串的指针

返回值

成功时为对应于 str 的内容的整数值。若转换的值落在对应的返回类型范围外,则返回值未定义。

若无法进行转换,则返回 0

注解

其名字代表“ASCII to integer”。

示例

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    printf("%i\n", atoi(" -123junk"));
    printf("%i\n", atoi(" +321dust"));
    printf("%i\n", atoi("0"));
    printf("%i\n", atoi("0042")); // 当做代用前导零的十进制数
    printf("%i\n", atoi("0x2A")); // 仅转换前导零,丢弃 "x2A"
    printf("%i\n", atoi("junk")); // 无可进行的转换
    printf("%i\n", atoi("2147483648")); // UB:在 int 范围外
}

可能的输出:

-123
321
0
42
0
0
-2147483648

引用

  • C17 标准(ISO/IEC 9899:2018):
  • 7.22.1.2 The atoi, atol, and atoll functions (第 249 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.22.1.2 The atoi, atol, and atoll functions (第 341 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.20.1.2 The atoi, atol, and atoll functions (第 307 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.10.1.2 The atoi function
  • 4.10.1.3 The atol function

参阅

将字节字符串转换成整数值
(函数)
将字节字符串转换成无符号整数值
(函数)
(C95)(C99)
将宽字符串转换成整数值
(函数)
将宽字符串转换成无符号整数值
(函数)