文字列を数値に変換する関数

  • [アーティクル]

解説

ファミリ内の各関数は strto* 、null で終わる文字列を数値に変換します。 利用できる関数を次の表に示します。

機能 説明
strtod 文字列を倍精度浮動小数点値に変換する
strtol 文字列を long 型整数に変換する
strtoul 文字列を unsigned long 型整数に変換する
_strtoi64 文字列を 64 ビット __int64 整数に変換する
_strtoui64 文字列を符号なし 64 ビット __int64 整数に変換する

wcstod、wcstol、wcstoul、_wcstoi64 は、それぞれ、strtod、strtol、strtoul、_strtoi64 のワイド文字バージョンです。 これらのワイド文字関数の文字列引数はワイド文字です。各関数は、それが 1 バイト文字列の場合と同様に動作します。

この関数は strtod 2 つの引数を受け取ります。1 つ目は入力文字列、2 番目は変換プロセスを終了する文字へのポインターです。 strtolを strtoulクリックし、 _strtoi64_strtoui64 変換プロセスで使用する数値ベースとして 3 番目の引数を取ります。

入力文字列は、指定された型の数値として解釈できる文字シーケンスです。 各関数は、数値の一部として認識できない最初の文字で文字列の読み取りを停止します。 この文字は、終端の NULL 文字の場合があります。 strtol、strtoul、_strtoi64、_strtoui64 の場合、この終端文字は、ユーザーが指定した基数と等しいか、それより大きい最初の数字になることもあります。

ユーザー指定の変換終了文字へのポインターが呼び出し時またはnullptr呼び出し時にNULL設定されていない場合は、スキャンを停止した文字へのポインターが代わりにそこに格納されます。 変換できなかった場合 (有効な数字が見つからなかったか、無効な基数を指定した場合) は、文字列ポインターの値がそのアドレスに保存されます。

strtod は、次の形式の文字列を要求します。

[whitespace] [sign] [digits] [.digits] [{d | D | e | E}[sign]digits]

A は whitespace スペースまたはタブ文字で構成され、無視 sign されます。プラス (+) またはマイナス (-)、 digits 1 桁以上の 10 進数字です。 小数点文字の前に数字がない場合は、少なくとも 1 つの数字が小数点文字の後に必要です。 10 進数の後には指数部を指定できます。指数部は、指数部の開始文字 (d、D、e、または E) および必要に応じて符号付き整数で構成されます。 指数部または基数文字が表示されない場合、基数文字は文字列の最後の桁の後にあると見なされます。 この形式に一致しない最初の文字でスキャンが停止します。

strtol、strtoul、_strtoi64、_strtoui64 関数は、次の形式の文字列を要求します。

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

基本引数が 2 ~ 36 の場合は、数値の底として使用されます。 0 の場合、変換終了ポインターによって参照される最初の文字を使用して、ベースが決定されます。 最初の文字が 0 で、2 番目の文字が 'x' または 'X' でない場合、文字列は 8 進数として解釈されます。それ以外の場合は、10 進数として解釈されます。 最初の文字が '0' で、2 番目の文字が 'x' または 'X' である場合、文字列は 16 進数と解釈されます。 最初の文字が '1' ～ '9' の間の数値の場合、文字列は 10 進数と解釈されます。 'a' ～ 'z' (または 'A' ～ 'Z') の文字には、10 ～ 35 の値が割り当てられています。base よりも小さい値が割り当てられている文字のみ許可されます。 strtoul と _strtoui64 では正符号 (+) または負符号 (-) のプレフィックスを使用できます。先頭の負符号は戻り値の符号が反転されることを表します。

出力値は、ロケールの LC_NUMERIC カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないこれらの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。

これらの関数によって返される値がオーバーフローまたはアンダーフローを引き起こす場合、または変換できない場合は、次のように特殊なケース値が返されます。

機能 状態 返される値
strtod オーバーフロー +/- HUGE_VAL
strtod アンダーフローまたは変換なし 0
strtol + オーバーフロー LONG_MAX
strtol - オーバーフロー LONG_MIN
strtol アンダーフローまたは変換なし 0
_strtoi64 + オーバーフロー _I64_MAX
_strtoi64 - オーバーフロー _I64_MIN
_strtoi64 変換なし 0
_strtoui64 オーバーフロー _UI64_MAX
_strtoui64 変換なし 0

_I64_MAXで_I64_MIN_UI64_MAX定義<LIMITS.H>されます。

wcstod、wcstol、wcstoul、_wcstoi64、_wcstoui64 はそれぞれ、strtod、strtol、strtoul、_strtoi64、_strtoui64 のワイド文字バージョンです。これらのワイド文字関数の変換終了引数へのポインターはワイド文字です。 ワイド文字関数は、それが 1 バイト文字の場合と同様に動作します。

関連項目

データ変換
ロケール
マルチバイト文字シーケンスの解釈
数学と浮動小数点のサポート
atof, _atof_l, _wtof, _wtof_l