Namespaces
Variants

std:: strtof, std:: strtod, std:: strtold

From cppreference.net
ヘッダー <cstdlib> で定義
float strtof ( const char * str, char ** str_end ) ;
(1) (C++11以降)
double strtod ( const char * str, char ** str_end ) ;
(2)
long double strtold ( const char * str, char ** str_end ) ;
(3) (C++11以降)

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

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

  • 10進浮動小数点式。以下の部分で構成されます:
  • (オプション) プラスまたはマイナス記号
  • 空でない10進数のシーケンス(現在のC locale で決定される)に、オプションで小数点文字を含む(仮数部を定義)
  • (オプション) e または E に続き、オプションのマイナスまたはプラス記号と空でない10進数のシーケンス(基数 10 の指数を定義)
  • 16進浮動小数点数表現。以下の部分で構成される:
  • (オプション) プラスまたはマイナス記号
  • 0x または 0X
  • 空でない16進数字の列(現在のC ロケール で決定される)十進小数点文字をオプションで含む(仮数を定義)
  • (オプション) p または P に続く、オプションのマイナスまたはプラス記号と空でない10進数字の列(基数 2 の指数を定義)
  • 無限大表現。以下の部分で構成される:
  • (オプション) プラスまたはマイナス記号
  • INF または INFINITY 大文字小文字を無視
  • 非数(NaN)表現。以下の部分で構成される:
  • (オプション) プラスまたはマイナス記号
  • NAN または NAN( char_sequence  ) NAN 部分の大文字小文字を無視。 char_sequence は数字、ラテン文字、アンダースコアのみを含むことができる。結果はquiet NaN浮動小数点値となる。
(C++11以降)
  • 現在インストールされているC locale で受け入れられる可能性のあるその他の式。

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

目次

パラメータ

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

戻り値

成功時、 str の内容に対応する浮動小数点値。変換された値が対応する戻り値の型の範囲外の場合、範囲エラーが発生し、 HUGE_VAL HUGE_VALF または HUGE_VALL が返される。変換が実行できない場合、 0 が返され、 * str_end str に設定される。

#include <cerrno>
#include <clocale>
#include <cstdlib>
#include <iostream>
#include <string>
int main()
{
    const char* p = "111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz";
    char* end{};
    std::cout << "Parsing \"" << p << "\":\n";
    errno = 0;
    for (double f = std::strtod(p, &end); p != end; f = std::strtod(p, &end))
    {
        std::cout << "  '" << std::string(p, end - p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            std::cout << "range error, got ";
            errno = 0;
        }
        std::cout << f << '\n';
    }
    if (std::setlocale(LC_NUMERIC, "de_DE.utf8"))
    {
        std::cout << "With de_DE.utf8 locale:\n";
        std::cout << "  '123.45' -> " << std::strtod("123.45", 0) << '\n';
        std::cout << "  '123,45' -> " << std::strtod("123,45", 0) << '\n';
    }
}

出力例:

Parsing "111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz":
  '111.11' -> 111.11
  ' -2.22' -> -2.22
  ' 0X1.BC70A3D70A3D7P+6' -> 111.11
  ' -Inf' -> -inf
  ' 1.18973e+4932' -> range error, got inf
With de_DE.utf8 locale:
  '123.45' -> 123
  '123,45' -> 123.45

関連項目

バイト文字列を浮動小数点値に変換する
(関数)
ワイド文字列を浮動小数点値に変換する
(関数)
(C++17)
文字シーケンスを整数または浮動小数点値に変換する
(関数)
Cドキュメント for strtof , strtod , strtold