strtof, strtod, strtold

ヘッダー `<stdlib.h>` で定義
float strtof ( const char* restrict str, char** restrict str_end );	(1)	(C99以降)
	(2)
double strtod ( const char* str, char** str_end );			(C99まで)
double strtod ( const char* restrict str, char** restrict str_end );			(C99以降)
long double strtold( const char* restrict str, char** restrict str_end );		(3)	(C99以降)

str が指すバイト文字列中の浮動小数点値を解釈します。

関数は、まず isspace によって決定される空白文字をすべて破棄します。その後、最初の非空白文字が見つかるまで処理を進めます。そして、有効な浮動小数点表現を形成できるだけの文字をできるだけ多く取り込み、それを浮動小数点値に変換します。有効な浮動小数点値は以下のいずれかになります。

10進数浮動小数点表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
十進数の数字の空でないシーケンス。必要に応じて小数点文字（現在の C ロケールによって決定される）を含む（仮数部を定義する）。
(任意)eまたはE、それにオプションのマイナスまたはプラス記号と10進数字の非空のシーケンスが続く（ $10$ を底とする指数を定義する）。

16進数浮動小数点表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
0xまたは0X
16進数の数字の空でないシーケンス。必要に応じて小数点文字（現在の C ロケールによって決定される）を含む（仮数部を定義する）。
(任意)pまたはP、それにオプションのマイナスまたはプラス記号と10進数字の非空のシーケンスが続く（ $2$ を底とする指数を定義する）。

無限大表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
INFまたはINFINITY（大文字・小文字を区別しない）。

非数（NaN）表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
NANまたはNAN(char_sequence )（NAN部分の大文字・小文字は区別しない。*char_sequence*は数字、ラテン文字、アンダースコアのみを含むことができる。結果はクワイエットNaN浮動小数点値となる。

(C99以降)

現在インストールされている C ロケールによって受け入れられる可能性のあるその他の任意の式。

str_end が指すポインタは、解釈された最後の文字の次の文字を指すように設定されます。str_end がヌルポインタの場合、無視されます。

成功した場合、str の内容に対応する浮動小数点値を返します。変換された値が対応する戻り値の型のはずれ値となる場合、範囲エラーが発生し（errno に ERANGE が設定されます）、HUGE_VAL、HUGE_VALF、または HUGE_VALL が返されます。変換がまったく実行できなかった場合、0 が返されます。

[編集] 例

このコードを実行

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    // parsing with error handling
    const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (double f = strtod(p, &end); p != end; f = strtod(p, &end))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
 
    // parsing without error handling
    printf("\"  -0.0000000123junk\"  -->  %g\n", strtod("  -0.0000000123junk", NULL));
    printf("\"junk\"                 -->  %g\n", strtod("junk", NULL));
}

実行結果の例

Parsing '111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz':
'111.11' -> 111.110000
' -2.22' -> -2.220000
' Nan' -> nan
' nan(2)' -> nan
' inF' -> inf
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf
"  -0.0000000123junk"  -->  -1.23e-08
"junk"                 -->  0

[編集] 参照

C23標準 (ISO/IEC 9899:2024)

7.22.1.3 The strtod, strtof, and strtold functions (p: TBD)

C17標準 (ISO/IEC 9899:2018)

7.22.1.3 The strtod, strtof, and strtold functions (p: 249-251)

C11標準 (ISO/IEC 9899:2011)

7.22.1.3 The strtod, strtof, and strtold functions (p: 342-344)

C99標準 (ISO/IEC 9899:1999)

7.20.1.3 The strtod, strtof, and strtold functions (p: 308-310)

C89/C90標準 (ISO/IEC 9899:1990)

4.10.1.4 The strtod function

[編集] 関連項目

atof	バイト文字列を浮動小数点値に変換する (関数) [編集]
wcstofwcstodwcstold (C99)(C95)(C99)	ワイド文字列を浮動小数点数値に変換する (関数) [編集]
C++ ドキュメント for strtof, strtod, strtold

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

strtof, strtod, strtold

目次

[編集] パラメータ

[編集] 戻り値

[編集] 例

[編集] 参照

[編集] 関連項目

ナビゲーション

ツールボックス

str	-	解釈されるヌル終端バイト文字列へのポインタ
str_end	-	文字へのポインタへのポインタ