atoi, atol, atoll

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

字符串库

字节字符串

多字节字符串

宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换成数值格式
atof atoiatolatoll (C99) strtolstrtoll (C99)	strtoulstrtoull (C99) strtofstrtodstrtold (C99)(C99) strtoimaxstrtoumax (C99)(C99)
字符串操作
strcpystrcpy_s (C11)
strncpystrncpy_s (C11)
strcatstrcat_s (C11)
strncatstrncat_s (C11)
strxfrm
strdup (C2x 起)
strndup (C2x 起)
字符串检验
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr
memcmp
memsetmemset_s (C11)
memcpymemcpy_s (C11)
memmovememmove_s (C11)
memccpy (C2x 起)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义于头文件 <stdlib.h>
int       atoi( const char *str );
long      atol( const char *str );
long long atoll( const char *str );		(C99 起)

转译 str 所指的字节字符串中的整数值。

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

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

参数

str

-

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

返回值

成功时为对应 str 内容的整数值。若转换的值落在对应的返回类型范围外，则返回值未定义。若无法进行转换，则返回 ​0​ 。

示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    printf("%i\n", atoi(" -123junk"));
    printf("%i\n", atoi("0"));
    printf("%i\n", atoi("junk"));         // 无可进行的转换
    printf("%i\n", atoi("2147483648"));   // UB ：在 int 范围外
}

输出：

-123
0
0
-2147483648

引用

• C11 standard (ISO/IEC 9899:2011):

• 7.22.1.2 The atoi, atol, and atoll functions (p: 341)

• C99 standard (ISO/IEC 9899:1999):

• 7.20.1.2 The atoi, atol, and atoll functions (p: 307)

• C89/C90 standard (ISO/IEC 9899:1990):

• 4.10.1.2 The atoi function

• 4.10.1.3 The atol function

参阅

strtolstrtoll (C99)	将字节字符串转换成整数值 (函数)
strtoul strtoull (C99)	将字节字符串转换成无符号整数值 (函数)