Namespaces
Variants

std:: atof

From ja.cppreference.net
ヘッダーで定義 <cstdlib>
double atof ( const char * str ) ;

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 - 解釈されるヌル終了バイト文字列へのポインタ

戻り値

double 成功時には str の内容に対応する値。変換された値が戻り値の型の範囲外の場合、戻り値は未定義です。変換が実行できない場合、 0.0 が返されます。

例

#include <cstdlib>
#include <iostream>
int main()
{
    std::cout << std::atof("0.0000000123") << '\n'
              << std::atof("0.012") << '\n'
              << std::atof("15e16") << '\n'
              << std::atof("-0x1afp-2") << '\n'
              << std::atof("inF") << '\n'
              << std::atof("Nan") << '\n'
              << std::atof("invalid") << '\n';
}

出力:

1.23e-08
0.012
1.5e+17
-107.75
inf
nan
0

関連項目

(C++11) (C++11) (C++11)
文字列を浮動小数点値に変換する
(関数)
バイト文字列を浮動小数点値に変換する
(関数)
(C++17)
文字シーケンスを整数値または浮動小数点値に変換する
(関数)
バイト文字列を整数値に変換する
(関数)