std::wcstof, std::wcstod, std::wcstold

 

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)

 

空終止寬字串

函式
字元分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
字元操作
towlower towupper	towctrans wctrans
轉換為數字格式
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
字串操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
字串檢查
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
陣列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型別 wctrans_t wctype_t wint_t	宏 WCHAR_MIN WCHAR_MAX WEOF

 

在標頭檔案 <cwchar> 中定義
float       wcstof( const wchar_t* str, wchar_t** str_end );		(C++11 起)
double      wcstod( const wchar_t* str, wchar_t** str_end );
long double wcstold( const wchar_t* str, wchar_t** str_end );		(C++11 起)

解釋 str 指向的寬字串中的浮點值。

函式會忽略任何空白字元（由 std::iswspace 確定），直到找到第一個非空白字元。然後，它儘可能多地獲取字元以形成有效的浮點表示，並將其轉換為浮點值。有效的浮點值可以是以下之一：

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

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

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

(C++11 起)

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

函式將 str_end 指向的指標設定為指向已解釋的最後一個字元之後的寬字元。如果 str_end 是空指標，則忽略它。

引數

str	-	指向要解釋的以 null 結尾的寬字串的指標
str_end	-	指向寬字元指標的指標

返回值

成功時返回與 str 內容對應的浮點值。如果轉換後的值超出相應返回型別的範圍，則發生範圍錯誤並返回 HUGE_VAL、HUGE_VALF 或 HUGE_VALL。如果無法執行轉換，則返回 ​0​。

示例

執行此程式碼

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

輸出

Parsing L"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

參閱

strtofstrtodstrtold	將位元組字串轉換為浮點值 (函式)
C 文件 對應 wcstof