atoi、_atoi_l、_wtoi、_wtoi_l

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

文字列を整数に変換します。

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 です。

Visual C++ 2005 では、大きな負の整数値によるオーバーフローの場合は LONG_MIN が返されます。このような条件では、atoi と _wtoi は INT_MAX と INT_MIN を返します。すべての範囲外の値に対して、errno は ERANGE に設定されます。渡されたパラメータが NULL の場合、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、0 を返します。

解説

atoi 関数と _wtoi 関数は、文字列を整数値に変換します。入力文字列は、指定された型の数値として解釈できる文字の並びにします。関数は、入力文字列の読み込み時に、数値の一部として認識できない文字が現れた時点で停止します。この文字は、文字列の終わりを示す NULL ('\0' または L'\0') の場合もあります。

atoi 関数と _wtoi 関数の str 引数の形式は次のとおりです。

[whitespace] [sign] [digits]]

whitespace はスペースやタブで構成され、無視されます。sign は正符号 (+) または負符号 (–) のいずれかで、digits は 1 つ以上の 10 進数字です。

_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");
    }
}

Function: atoi( "  -2309 " ) = -2309
Function: atoi( "31412764" ) = 31412764
Function: atoi( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.