std::mbrtowc

 

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)

 

空終止多位元組字串

函式 寬/多位元組檢查 mblen mbrlen mbsinit 多位元組/寬字元轉換 mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

型別

mbstate_t

宏

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

在標頭檔案 <cwchar> 中定義
std::size_t mbrtowc( wchar_t* pwc,                      const char* s,                      std::size_t n,                      std::mbstate_t* ps );

將窄多位元組字元轉換為寬字元。

如果 s 不是空指標，則檢查多位元組字元字串的最多 n 個位元組，從 s 指向的位元組開始，以確定完成下一個多位元組字元所需的位元組數（包括任何移位序列）。如果函式確定 s 中的下一個多位元組字元是完整且有效的，則將其轉換為相應的寬字元並存儲在 *pwc 中（如果 pwc 不是空）。

如果 s 是空指標，則忽略 n 和 pwc 的值，並且呼叫等效於 std::mbrtowc(nullptr, "", 1, ps)。

如果生成的寬字元是空字元，則儲存在 *ps 中的轉換狀態是初始移位狀態。

引數

pwc	-	指向將寫入結果寬字元的位置的指標
s	-	指向用作輸入的多位元組字元字串的指標
n	-	s 中可檢查的位元組數的限制
ps	-	指向解釋多位元組字串時使用的轉換狀態的指標

返回值

以下適用情況中的第一個

• ​0​ 如果從 s 轉換的字元（如果非空則儲存在 pwc 中）是空字元。
• 成功從 s 轉換的多位元組字元的位元組數 [1...n]。
• static_cast<std::size_t>(-2) 如果接下來的 n 個位元組構成一個不完整但目前有效的多位元組字元。不會向 *pwc 寫入任何內容。
• static_cast<std::size_t>(-1) 如果發生編碼錯誤。不會向 *pwc 寫入任何內容，值 EILSEQ 儲存在 errno 中，*ps 的值未指定。

示例

執行此程式碼

#include <clocale>
#include <cstring>
#include <cwchar>
#include <iostream>
 
void print_mb(const char* ptr)
{
    std::mbstate_t state = std::mbstate_t(); // initial state
    const char* end = ptr + std::strlen(ptr);
    int len;
    wchar_t wc;
    while ((len = std::mbrtowc(&wc, ptr, end-ptr, &state)) > 0)
    {
        std::wcout << "Next " << len << " bytes are the character " << wc << '\n';
        ptr += len;
    }
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

輸出

Next 1 bytes are the character z
Next 2 bytes are the character ß
Next 3 bytes are the character 水
Next 4 bytes are the character 𝄋

參閱

mbtowc	將下一個多位元組字元轉換為寬字元 (函式)
wcrtomb	將寬字元轉換為其多位元組表示，給定狀態 (函式)
do_in [virtual] (虛擬函式)	將字串從 ExternT 轉換為 InternT，例如從檔案讀取時 (std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式)
C 文件 關於 mbrtowc