std::wctob

 

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> 中定義
int wctob( std::wint_t c );

將寬字元 c 窄化，如果其在初始轉換狀態下的多位元組字元等效項是單位元組。

這對於 ASCII 字元集中的字元通常是可能的，因為大多數多位元組編碼（如 UTF-8）都使用單位元組來編碼這些字元。

引數

c

-

要窄化的寬字元

返回值

如果 c 在初始轉換狀態下不表示長度為 1 的多位元組字元，則返回 EOF。

否則，返回 c 的單位元組表示形式（作為 unsigned char 轉換為 int）。

示例

執行此程式碼

#include <clocale>
#include <cwchar>
#include <iostream>
 
void try_narrowing(wchar_t c)
{
    int cn = std::wctob(c);
    if (cn != EOF)
        std::cout << '\'' << int(c) << "' narrowed to " << +cn << '\n';
    else
        std::cout << '\'' << int(c) << "' could not be narrowed\n";
}
 
int main()
{
    std::setlocale(LC_ALL, "th_TH.utf8");
    std::cout << std::hex << std::showbase << "In Thai UTF-8 locale:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
 
    std::setlocale(LC_ALL, "th_TH.tis620");
    std::cout << "In Thai TIS-620 locale:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
}

輸出

In Thai UTF-8 locale:
'0x61' narrowed to 0x61
'0xe5b' could not be narrowed
In Thai TIS-620 locale:
'0x61' narrowed to 0x61
'0xe5b' narrowed to 0xfb

參閱

btowc	如果可能，將單位元組窄字元加寬為寬字元 (函式)
narrow	窄化字元 (std::basic_ios<CharT,Traits> 的公共成員函式)
narrow	呼叫 do_narrow (std::ctype<CharT> 的公共成員函式)
C 文件 用於 wctob