atoi, atol, atoll
来自cppreference.com
在标头 <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
参阅
(C99) |
将字节字符串转换成整数值 (函数) |
(C99) |
将字节字符串转换成无符号整数值 (函数) |
(C95)(C99) |
将宽字符串转换成整数值 (函数) |
(C95)(C99) |
将宽字符串转换成无符号整数值 (函数) |