_atoi64， _atoi64_l， _wtoi64， _wtoi64_l

项目
02/21/2013

将字符串转换为 64 位整数。

__int64 _atoi64(
   const char *str 
);
__int64 _wtoi64(
   const wchar_t *str 
);
__int64 _atoi64_l(
   const char *str,
   _locale_t locale
);
__int64 _wtoi64_l(
   const wchar_t *str,
   _locale_t locale
);

参数

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

返回值

每个函数返回解释生成的 __int64 值类型字符为数字。，如果输入无法转换为该类型，的值返回值为 0 _atoi64 的。

对于与用正整数值的溢出， _atoi64 返回 I64_MAX 和 I64_MIN 在与用负整数值的溢出。

在所有超出范围的情况下， errno 设置为 ERANGE。如果传递的参数是 NULL，无效参数调用处理程序，如参数验证所述。如果执行允许继续，对 EINVAL 的这些功能集 errno 并且返回 0。

备注

这些函数将字符串转换为 64 位整数值。

输入字符串是可被解释为指定类型的一个数值字符的序列。函数停止读取输入字符串在作为数字的一部分，它无法识别的第一个字符。此字符可能是) 终止字符串的在 null 字符 (“\0' or L” \ 0 "。

为 _atoi64 的 str 参数具有以下形式:

[whitespace] [sign] [digits]]

whitespace 包括空格或制表符，将忽略; sign 加号 (+) 或减号 (-);并 digits 是一个或多个数字。

_wtoi64 与 _atoi64 与相同，但它采用宽字符字符串作为参数。

这些功能的版本与 _l 后缀的相同，只不过它们使用区域设置参数而不是当前区域设置。有关更多信息，请参见区域设置。

一般文本例程映射

Tchar.h 实例	未定义的 _UNICODE 和 _MBCS	定义的 _MBCS	定义的 _UNICODE
_tstoi64	_atoi64	_atoi64	_wtoi64
_ttoi64	_atoi64	_atoi64	_wtoi64

要求

实例	必需的头
_atoi64, _atoi64_l	stdlib.h
_wtoi64, _wtoi64_l	stdlib.h 或 wchar.h

示例

本过程演示作为字符串存储的数字中使用 _atoi64 功能，如何转换为数值。

// crt_atoi64.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the _atoi64 functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

    // An example of the _atoi64 function
    // with leading and trailing white spaces.
    str = "  -2309 ";
    value = _atoi64( str );
    printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );

    // Another example of the _atoi64 function 
    // with an arbitrary decimal point.
    str = "314127.64";
    value = _atoi64( str );
    printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );

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