次の方法で共有


_atoi64、_atoi64_l、_wtoi64、_wtoi64_l

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 の値が入力文字の数として解釈によって生成された関数はを返します。戻り値は入力がその型の値に変換できない場合は**_atoi64** の 0 です。

大きい正の整数値を使用してオーバーフローの場合**_atoi64**大きく負の整数値でオーバーフローの場合は I64_MAX と I64_MIN を返します。

すべての範囲の場合errno は ERANGE に設定されます。渡されるパラメーターが NULL いるように無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可 EINVAL し0 に設定する errno 関数。

解説

これらの関数は 64 ビットの整数値に文字列をに変換します。

入力文字列は指定した型の数値として解釈できる文字のシーケンスです。関数は数値の一部として認識できない最初の文字の入力文字列の読み取りを停止します。この文字列は文字を終了する null 文字 (「 \ 0 " または 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");
    }
}
  

同等の .NET Framework 関数

参照

関連項目

データ変換

浮動小数点サポート

ロケール

_ecvt

_fcvt

_gcvt

setlocale、_wsetlocale

_atodbl、_atodbl_l、_atoldbl、_atoldbl_l、_atoflt _atoflt_l