std::mbtowc

 

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)

 

定義於標頭檔案 <cstdlib>
int mbtowc( wchar_t* pwc, const char* s, std::size_t n );

將指向 s 的首位元組的多位元組字元轉換成寬字元，如果 pwc 非空則寫入 *pwc。

如果 s 是空指標，則重置全域性轉換狀態並確定是否使用移位序列。

引數

s	-	指向多位元組字元的指標
n	-	s 中可檢查的位元組數的限制
pwc	-	輸出寬字元的指標

返回值

如果 s 不是空指標，返回多位元組字元所包含的位元組數，如果 s 指向的首位元組不構成有效的多位元組字元則返回 -1，如果 s 指向空字元 '\0' 則返回 ​0​。

如果 s 是空指標，重置其內部轉換狀態以表示初始移位狀態，如果當前多位元組編碼不依賴於狀態（不使用移位序列）則返回 ​0​，如果當前多位元組編碼依賴於狀態（使用移位序列）則返回非零值。

注意

每次對 mbtowc 的呼叫都會更新內部全域性轉換狀態（型別為 std::mbstate_t 的靜態物件，僅此函式可見）。如果多位元組編碼使用移位狀態，必須小心避免回溯或多次掃描。在任何情況下，多個執行緒不應在沒有同步的情況下呼叫 mbtowc：可以使用 std::mbrtowc 代替。

示例

執行此程式碼

#include <clocale>
#include <cstdlib>
#include <cstring>
#include <iostream>
 
int print_mb(const char* ptr)
{
    std::mbtowc(nullptr, 0, 0); // reset the conversion state
    const char* end = ptr + std::strlen(ptr);
    int ret{};
    for (wchar_t wc; (ret = std::mbtowc(&wc, ptr, end - ptr)) > 0; ptr += ret)
        std::wcout << wc;
    std::wcout << '\n';
    return ret;
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = "z\u00df\u6c34\U0001d10b"; // or "zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

輸出

zß水𝄋

參閱

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