功能

atoi()函数将数字格式的字符串转换为整数类型。例如，将字符串“12345”转换成数字12345。

格式

该函数的格式为

int atoi(const char* str)

其中，参数str是要转换的字符串，返回值是转换后的整数。

 注意事项

关于参数的注意事项

在“格式”中提到，atoi()函数的参数是要转换的字符串。该字符串的格式为

[空格][符号][数字]

其中，空格可以是键盘中的空格字符或者是Tab字符；符号可以是表示正数的“+”，也可以是表示负数的“-”；数字即为数字字符串。所以，atoi()函数参数可以是

“ +123”

“ -456”

需要注意的是，空格和“+”可以省略。所以，atoi()函数参数还可以是

“123”

“-456”

 关于返回值的注意事项

如果atoi()函数转换成功，则该函数的返回值是转换后的整型。如果atoi()函数转换失败，例如要转换的类型超过了int表示的范围，如果要转换的是正数，则返回INT_MAX（2147483647），如果要转换的是负数，则返回INT_MIN（-2147483648）。代码如下所示

str1 = " 3336402735171707160320";

value1 = atoi(str1);

if (INT_MAX == value1) {
    printf("要转换的值超出了int的上边界。\n");
}

str2 = " -3336402735171707160320";

value2 = atoi(str2);

if (INT_MIN == value2) {
    printf("要转换的值超出了int的下边界。\n");

}

需要注意的是，atoi()函数在stdlib.h中定义，所以在使用atoi()函数时，需要包含该头文件。

atoi()函数当读取到参数中的’\0’字符时，停止读取并返回。

判断转换是否成功

虽然atoi()函数的参数和返回值中不包含转换是否成功的标志，但是可以通过系统变量errno的值来判断转换是否成功。

相关链接：

系统变量errno：errno 是记录系统的最后一次错误代码。代码是一个int型的值，在errno.h中定义。查看错误代码errno是调试程序的一个重要方法。

在调用atoi()函数时，如果转换成功，则errno的值是0；如果遇到“3.2 关于返回值的注意事项”中提到的超出范围错误时，errno的值将会被设置为ERANGE。

if (errno == ERANGE) {
    printf("要转换的数字超出int范围.\n");

}

宽字符的转换

atoi()函数的宽字符串版本是_wtoi()函数。该函数的格式为

int _wtoi(const wchar_t* str);

其参数与返回值的含义与atoi()函数相似。