命名空间
变体
操作

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 - 指向要解释的以 null 结尾的字节字符串的指针

[编辑] 返回值

成功时,与 str 内容相对应的整数值。

如果无法执行转换,则返回 0

[编辑] 备注

名称代表“ASCII 到整数”。

[编辑] 示例

#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")); // treated as a decimal number with leading zeros
    printf("%i\n", atoi("0x2A")); // only leading zero is converted discarding "x2A"
    printf("%i\n", atoi("junk")); // no conversion can be performed
    printf("%i\n", atoi("2147483648")); // UB: out of range of int
}

可能的输出

-123
321
0
42
0
0
-2147483648

[编辑] 参考

  • C17 标准 (ISO/IEC 9899:2018)
  • 7.22.1.2 atoi、atol 和 atoll 函数 (p: 249)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.22.1.2 atoi、atol 和 atoll 函数 (p: 341)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.20.1.2 atoi、atol 和 atoll 函数 (p: 307)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.10.1.2 atoi 函数
  • 4.10.1.3 atol 函数

[编辑] 参见

将字节字符串转换为整数值
(函数) [编辑]
将字节字符串转换为无符号整数值
(函数) [编辑]
(C95)(C99)
将宽字符串转换为整数值
(函数) [编辑]
将宽字符串转换为无符号整数值
(函数) [编辑]
C++ 文档 for atoi, atol, atoll