std::atof

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端バイト文字列

関数
文字の分類
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
文字操作
tolower	toupper
数値フォーマットへの変換
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
文字列操作
strcpy strncpy strxfrm	strcat strncat
文字列検査
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
文字配列関数
memchr memcmp memset	memcpy memmove
その他
strerror

 

ヘッダ <cstdlib> で定義
double atof( const char* str );

str で指されるバイト文字列を浮動小数点値として解釈します。

関数は、最初の空白でない文字が見つかるまで、std::isspace で決定される空白文字をすべて破棄します。次に、有効な浮動小数点表現を形成するために可能な限り多くの文字を取得し、それらを浮動小数点値に変換します。有効な浮動小数点値は、次のいずれかになります。

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

• (任意)プラスまたはマイナスの記号
• 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浮動小数点値となる。

(C++11以降)

• 現在インストールされているC ロケールで受け入れられる可能性のあるその他の表現。

パラメータ

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

関連項目

stofstodstold (C++11)(C++11)(C++11)	文字列を浮動小数点値に変換する (function)
strtofstrtodstrtold	バイト文字列を浮動小数点値に変換する (関数)
from_chars (C++17)	文字シーケンスを整数値または浮動小数点数値に変換する (関数)
atoiatolatoll (C++11)	バイト文字列を整数値に変換する (関数)
C のドキュメント （atof について）