atoi、 _atoi_l、 _wtoi、 _wtoi_l

發行項
02/28/2013

將字串轉換成整數。

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值所產生的解譯為數字的輸入的字元。傳回值是 0， atoi 和**_wtoi**，如果輸入無法轉換成該型別的值。

具有較大的負整數值，溢位的情況下LONG_MIN會傳回。 atoi與**_wtoi傳回INT_MAX和INT_MIN在這種情況。在所有範圍外的情況下， errno設定為 [ ERANGE。如果傳入的參數是NULL，不正確的參數處理常式會叫用，如所述參數驗證。如果執行，則允許繼續執行，這些函式會設定errno**到EINVAL ，並傳回 0。

備註

這些函式會將字元字串轉換成整數值 (atoi和_wtoi)。輸入的字串是一連串的字元會解譯為指定之型別的數值。此函式會停止讀取輸入無法辨識的數字的組件的第一個字元字串。這個字元可以是 null 字元 ('\ 0' 或 '\ 0' L) 結束的字串。

str引數為atoi和**_wtoi**都採用下列格式：

[whitespace] [sign] [digits]]

A whitespace包含空格或 tab 字元，會被忽略； 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");
    }
}