std::wcstoul, std::wcstoull

 

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> 中定義
unsigned long      wcstoul ( const wchar_t* str, wchar_t** str_end, int base );
unsigned long long wcstoull( const wchar_t* str, wchar_t** str_end, int base );		(C++11 起)

解釋 str 指向的寬字串中的無符號整數值。

丟棄任何空白字元（透過呼叫 std::iswspace 識別），直到找到第一個非空白字元，然後儘可能多地取字元以形成一個有效的 base-n（其中 n=base）無符號整數表示，並將其轉換為整數值。有效的無符號整數值由以下部分組成：

• (可選) 加號或減號
• (可選) 字首 (0) 表示八進位制基數（僅當基數為 8 或 ​0​ 時適用）
• (可選) 字首 (0x 或 0X) 表示十六進位制基數（僅當基數為 16 或 ​0​ 時適用）
• 一系列數字

base 的有效值集為 {0, 2, 3, ..., 36}。base-2 整數的有效數字集為 {0, 1}，base-3 整數為 {0, 1, 2}，依此類推。對於大於 10 的基數，有效數字包括字母字元，從 base-11 整數的 Aa 開始，到 base-36 整數的 Zz 結束。字元的大小寫被忽略。

當前安裝的 C locale 可能會接受其他數字格式。

如果 base 的值為 ​0​，則自動檢測數字基數：如果字首是 0，則基數為八進位制；如果字首是 0x 或 0X，則基數為十六進位制；否則基數為十進位制。

如果減號是輸入序列的一部分，則從數字序列計算出的數值將被取反，如同結果型別中的一元減號操作一樣，這將應用無符號整數環繞規則。

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

引數

str	-	指向要解釋的以 null 結尾的寬字串的指標
str_end	-	指向寬字元指標的指標
base	-	被解釋整數值的*基數*

返回值

成功時，返回對應於 str 內容的整數值。如果轉換後的值超出相應返回型別的範圍，則發生範圍錯誤並返回 ULONG_MAX 或 ULLONG_MAX。如果無法執行轉換，則返回 ​0​。

示例

執行此程式碼

#include <cwchar>
#include <errno.h>
#include <iostream>
#include <string>
 
int main()
{
    const wchar_t* p = L"10 200000000000000000000000000000 30 40";
    wchar_t* end;
    std::wcout << "Parsing L'" << p << "':\n";
    for (unsigned long i = std::wcstoul(p, &end, 10);
         p != end;
         i = std::wcstoul(p, &end, 10))
    {
        std::wcout << '\'' << std::wstring(p, end - p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            std::wcout << "range error, got ";
            errno = 0;
        }
        std::wcout << i << '\n';
    }
}

可能的輸出

Parsing L'10 200000000000000000000000000000 30 40':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' 40' -> 40

參閱

strtoulstrtoull (C++11)	將位元組字串轉換為無符號整數值 (函式)
wcstolwcstoll	將寬字串轉換為整數值 (函式)
C 文件 for wcstoul, wcstoull