_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

文字列を __int64 値に変換します。

構文

__int64 _strtoi64(
   const char *strSource,
   char **endptr,
   int base
);
__int64 _wcstoi64(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base
);
__int64 _strtoi64_l(
   const char *strSource,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

パラメーター

strSource
NULL で終わる変換対象の文字列。

endptr
スキャンの終了位置を示す文字へのポインター。

base
使用する基数。

locale
使用するロケール。

戻り値

_strtoi64 は、オーバーフローを引き起こす場合を除き、文字列 strSource で表現される値を返します。オーバーフローの場合は、_I64_MAX または _I64_MIN を返します。 この関数は、変換を実行できない場合には 0 を返します。 _wcstoi64 関数の戻り値は、_strtoi64 関数の戻り値と同じです。

_I64_MAX、および _I64_MIN は、LIMITS.H で定義されます。

strSourceNULL または base がゼロ以外で 2 未満または 36 を超える場合、errnoEINVAL に設定されます。

リターン コードの詳細については、「errno_doserrno_sys_errlist、および _sys_nerr」を参照してください。

解説

_strtoi64 関数は、strSource__int64 に変換します。 どちらの関数も、数値の一部として認識できない最初の文字で文字列 strSource の読み取りを停止します。 終端の null 文字を使用するか、または最初の数値が次の値以上 baseの場合があります。 _wcstoi64 関数は、_strtoi64 関数のワイド文字バージョンで、strSource 引数はワイド文字列です。 それ以外では、これらの関数の動作は同じです。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 これを変更するには、「CRT でのグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

TCHAR.H ルーチン _UNICODE_MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_tcstoi64 _strtoi64 _strtoi64 _wcstoi64
_tcstoi64_l _strtoi64_l _strtoi64_l _wcstoi64_l

ロケールの LC_NUMERIC カテゴリ設定によって、基数文字 strSourceの認識が決定されます。詳細については、「.」を参照してください setlocale。 サフィックスのない_l関数は現在のロケールを使用し、_strtoi64_lサフィックスのない_l対応する関数と_wcstoi64_l同じですが、代わりに渡されたロケールを使用する点が異なります。 詳細については、「 Locale」を参照してください。

endptrNULL 以外の場合は、スキャンを停止させた文字へのポインターを endptr が指す位置に格納します。 変換できなかった場合 (有効な数字が見つからなかった場合、または無効な base を指定した場合) は、strSource の値を endptr が指す位置に格納します。

_strtoi64 は、strSource が次の形式の文字列を指すものと想定します。

[whitespace] [{+ | -}] [0 [{ x | X }]] [digits | letters]

whitespace は、空白文字とタブ文字で構成でき、無視されます。 digits は、1 個以上の 10 進数です。 letters は、'a' から 'z' (または 'A' から 'Z' まで) の 1 つ以上の文字です。 この形式に一致しない最初の文字でスキャンが停止します。 base が 2 から 36 の間の場合、数値の基数として使用されます。 base が 0 の場合、strSource が指す文字列の先頭の文字を使用して、基数を判断します。 最初の文字が '0' で、2 番目の文字が 'x' または 'X' でない場合、文字列は 8 進数として解釈されます。 最初の文字が '0' で、2 番目の文字が 'x' または 'X' である場合、文字列は 16 進数と解釈されます。 最初の文字が '1' ~ '9' の間の数値の場合、文字列は 10 進数と解釈されます。 'a' ~ 'z' (または 'A' ~ 'Z') の文字には、10 ~ 35 の値が割り当てられています。base よりも小さい値が割り当てられている文字のみ許可されます。 基数の範囲外にある文字を最初に見つけた時点で、スキャンは停止されます。 たとえば、base が 0 で、スキャンされた最初の文字が '0' の場合、8 進数と見なされ、'8' または '9' の文字が出現すると、スキャンは停止されます。

必要条件

機能 必須ヘッダー
_strtoi64, _strtoi64_l <stdlib.h>
_wcstoi64, _wcstoi64_l <stdlib.h> または <wchar.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

データ変換
ロケール
localeconv
setlocale, _wsetlocale
文字列から数値の関数
strtod, _strtod_l, wcstod, _wcstod_l
strtoul, _strtoul_l, wcstoul, _wcstoul_l
atof, _atof_l, _wtof, _wtof_l