strtol、wcstol、_strtol_l、_wcstol_l
文字列を長整数型 (long) の値に変換します。
long strtol(
const char *nptr,
char **endptr,
int base
);
long wcstol(
const wchar_t *nptr,
wchar_t **endptr,
int base
);
long _strtol_l(
const char *nptr,
char **endptr,
int base,
_locale_t locale
);
long _wcstol_l(
const wchar_t *nptr,
wchar_t **endptr,
int base,
_locale_t locale
);
パラメーター
nptr
NULL で終わる変換対象の文字列。endptr
スキャンの終了位置を示す文字へのポインター。base
使用する基数。locale
使用するロケール。
戻り値
strtol 関数は、オーバーフローを引き起こす場合を除き、文字列 nptr で表される値を返します。オーバーフローの場合は、LONG_MAX または LONG_MIN を返します。 変換を実行できなかった場合は、strtol 関数は 0 を返します。 wcstol 関数の戻り値は、strtol 関数の戻り値と同じです。 どちらの関数も、オーバーフローまたはアンダーフローが発生すると、グローバル変数 errno に ERANGE を設定します。
戻り値の詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
strtol 関数は、nptr を long に変換します。 strtol 関数は、数値の一部として認識できない文字を最初に見つけた時点で、文字列 nptr の読み取りを終了します。 文字列の終端の null 文字 (\0)、または base 以上の数値文字が最初に出現した位置でもスキャンを停止します。
wcstol 関数は、strtol 関数のワイド文字バージョンで、nptr 引数はワイド文字列です。 それ以外では、これらの関数の動作は同じです。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcstol |
strtol |
strtol |
wcstol |
_tcstol_l |
_strtol_l |
_strtol_l |
_wcstol_l |
現在のロケールの LC_NUMERIC カテゴリの設定に基づいて nptr の小数点文字が認識されます。詳細については、setlocale 関数の解説を参照してください。 これらのうち _l サフィックスが付いていない関数では、現在のロケールを使用します。_strtol_l と _wcstol_l は、渡されたロケールを使用することを除いて _l サフィックスが付いていない対応する関数と同じです。 詳細については、「ロケール」を参照してください。
endptr が NULL 以外の場合は、スキャンを停止させた文字へのポインターを endptr が指す位置に格納します。 変換できなかった場合 (有効な数字が見つからなかった場合、または無効な base を指定した場合) は、nptr の値を endptr が指す位置に格納します。
strtol trtol は、nptr が次の形式の文字列を指すものと想定します。
[whitespace] [{+ |–}] [0 [{ x |X }]] [digits]
whitespace は、スペースまたはタブ文字のことであり、無視されます。digits は 1 つ以上の 10 進数字です。 この形式に一致しない文字を見つけるとスキャンを停止します。 base が 2 と 36 の間の場合は、基数として使用されます。 base が 0 の場合は、nptr が指す文字列の先頭の文字で基数を判定します。 最初の文字が 0 で、2 番目の文字が x または X 以外であると、文字列は 8 進整数と解釈されます。それ以外の場合は、10 進数と解釈されます。 最初の文字が 0 で、2 番目の文字が x または X である場合、文字列は 16 進整数と解釈されます。 最初の文字が 1 から 9 までの数値であると、文字列は 10 進整数と解釈されます。 a ~ z (または A ~ Z) の文字は、10 ~ 35 の値に割り当てます。数値に使用できる文字は、base より小さい値が割り当てられている文字だけです。
必要条件
ルーチン |
必須ヘッダー |
---|---|
strtol |
<stdlib.h> |
wcstol |
<stdlib.h> または <wchar.h> |
_strtol_l |
<stdlib.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
「strtod」の例を参照してください。
同等の .NET Framework 関数
参照
参照
strtod、_strtod_l、wcstod、_wcstod_l