strtof, strtod, strtold

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

関数は（ isspace によって判定される）空白文字を最初の非空白文字が見つかるまで破棄します。その後、有効な浮動小数点表現を形成するために可能な限り多くの文字を取り込み、それらを浮動小数点値に変換します。有効な浮動小数点値は以下のいずれかです：

• 10進浮動小数点式。以下の部分で構成されます：

• (オプション) プラスまたはマイナス記号
• 空でない10進数のシーケンス（現在のC locale で決定される）に、オプションで小数点文字を含む（仮数部を定義）
• (オプション) e または E の後に、オプションのマイナスまたはプラス記号と空でない10進数のシーケンスが続く（基数 10 の指数を定義）

• 現在インストールされている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)
{
    // エラーハンドリング付きの解析
    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);
    }
    // エラーハンドリングなしの解析
    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

参考文献

関連項目