atoi、_atoi_l、_wtoi、_wtoi_l

项目
06/09/2015

Convert a string to integer.

int atoi(
   const char *str 
);
int _wtoi(
   const wchar_t *str 
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_l(
   const wchar_t *str,
   _locale_t locale
);

参数

str
要转换的字符串。
locale
要使用的区域设置。

返回值

每个函数返回 int 值，此值由将输入字符作为数字解析而生成。如果该输入无法转换为该类型的值，则 atoi 和**_wtoi** 的返回值为 0。

对于使用大量负整数值的溢出，则返回 LONG_MIN。 atoi 和 _wtoi 返回 INT_MAX 和 INT_MIN 对这些条件。在所有超出范围的情况下，errno 设置为 ERANGE。如果传递的参数为 NULL，则调用无效的参数处理程序，如参数验证中所述。如果允许继续执行，则这些函数将 errno 设置为 EINVAL，并返回 0。

备注

这些函数将字符串转换为整数值(atoi 和 _wtoi)。输入字符串是可被解释为指定类型的数值的字符序列。当第一个字符不能识别为数字时，函数将停止读入输入字符串。此字符可能是终止字符串的 null 字符（'\0' 或 L'\0'）。

str 参数传到 atoi 和 _wtoi 具有以下格式：

[whitespace] [sign] [digits]]

whitespace 包含已忽略的空格或制表符；sign 是加号 (+) 或减号 (-)；而 digits 是一个或多个数字。

这些带有 _l 后缀的函数的版本相同，只不过它们使用传递的区域设置参数而不是当前区域设置。有关详细信息，请参阅区域设置。

一般文本例程映射

TCHAR.H 例程	未定义的 _UNICODE& 和 _MBCS	已定义 _MBCS	已定义 _UNICODE
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

要求

例程	必需的标头
atoi	<stdlib.h>
_atoi_l, _wtoi, _wtoi_l	<stdlib.h> 或 <wchar.h>

示例

此过程演示如何使用 atoi 函数将作为字符串存储的数字转换为数值。

// crt_atoi.c
// This program shows how numbers 
// stored as strings can be converted to
// numeric values using the atoi functions.

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

int main( void )
{
    char    *str = NULL;
    int     value = 0;

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function 
    // with an overflow condition occuring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}