std::atof

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (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 確定），直到找到第一個非空白字元。然後它儘可能多地獲取字元以形成一個有效的浮點表示並將其轉換為浮點值。有效的浮點值可以是以下之一：

• 十進位制浮點表示式。它由以下部分組成：

• (可選) 加號或減號
• 非空十進位制數字序列，可選地包含小數點字元（由當前的 C 區域設定 確定）（定義有效數）
• (可選) e 或 E，後跟可選的減號或加號以及非空十進位制數字序列（定義以 10 為底的指數）

十六進位制浮點表示式。它由以下部分組成： (可選) 加號或減號 0x 或 0X 非空十六進位制數字序列，可選地包含小數點字元（由當前的 C 區域設定 確定）（定義有效數） (可選) p 或 P，後跟可選的減號或加號以及非空十進位制數字序列（定義以 2 為底的指數） 無窮大表達式。它由以下部分組成： (可選) 加號或減號 INF 或 INFINITY，不區分大小寫 非數字表達式。它由以下部分組成： (可選) 加號或減號 NAN 或 NAN(char_sequence )，忽略 NAN 部分的大小寫。char_sequence 只能包含數字、拉丁字母和下劃線。結果是一個安靜的 NaN 浮點值。

(C++11 起)

• 當前已安裝的 C 區域設定 可能接受的任何其他表示式。

引數

str

-

指向要解釋的空終止位元組字串的指標

返回值

成功時，返回對應於 str 內容的 double 值。如果轉換後的值超出返回類型範圍，則返回值為未定義。如果無法執行轉換，則返回 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)	將字串轉換為浮點值 (函式)
strtofstrtodstrtold	將位元組字串轉換為浮點值 (函式)
from_chars (C++17)	將字元序列轉換為整數或浮點值 (函式)
atoiatolatoll (C++11)	將位元組字串轉換為整數值 (函式)
C 文件，關於 atof