名稱空間
變體
操作

std::codecvt_utf8_utf16

來自 cppreference.com
< cpp‎ | locale
 
C++
 
文字處理庫
 
本地化庫
 
定義於標頭檔案 <codecvt>
template<

    class Elem,
    unsigned long Maxcode = 0x10ffff,
    std::codecvt_mode Mode = (std::codecvt_mode)0 >
class codecvt_utf8_utf16

    : public std::codecvt<Elem, char, std::mbstate_t>;
 (C++11 起)
(C++17 中已棄用)
(C++26 中移除)

std::codecvt_utf8_utf16 是一個 std::codecvt 面（facet），它封裝了 UTF-8 編碼位元組字串和 UTF-16 編碼字元字串之間的轉換。如果 Elem 是 32 位型別，則每個輸出序列的 32 位字元中將儲存一個 UTF-16 碼元。

這是一個 N:M 轉換面，不能與 std::basic_filebuf（它只允許內部編碼和外部編碼之間的 1:N 轉換，例如 UTF-32/UTF-8）一起使用。此面可與 std::wstring_convert 一起使用。

目錄

[編輯] 模板引數

Elem - 可以是 char16_t、char32_t 或 wchar_t
Maxcode - 此 facet 將無錯誤地讀取或寫入的 Elem 的最大值
Mode - 型別為 std::codecvt_mode 的常量

[編輯] 成員函式

(建構函式)
 構造新的 codecvt_utf8_utf16 面
(公開成員函式)
(解構函式)
 銷燬 codecvt_utf8_utf16 面
(公開成員函式)

std::codecvt_utf8_utf16::codecvt_utf8_utf16

explicit codecvt_utf8_utf16( std::size_t refs = 0 );

構造一個新的 std::codecvt_utf8_utf16 面，將初始引用計數器 refs 傳遞給基類。

引數

refs - 連結到 facet 的引用計數

std::codecvt_utf8_utf16::~codecvt_utf8_utf16

~codecvt_utf8_utf16();

銷燬 facet。與區域設定管理的 facet 不同，此 facet 的解構函式是公共的。

繼承自 std::codecvt

巢狀型別

型別 定義
intern_type internT
extern_type externT
state_type stateT

[編輯] 資料成員

成員 描述
std::locale::id id [static] facet 的識別符號

成員函式

 呼叫 do_out
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_in
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_unshift
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_encoding
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_always_noconv
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_length
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]
 呼叫 do_max_length
(std::codecvt<InternT,ExternT,StateT> 的公共成員函式) [編輯]

受保護的成員函式

[virtual]
 將字串從 InternT 轉換為 ExternT，例如寫入檔案時
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 將字串從 ExternT 轉換為 InternT，例如從檔案讀取時
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 為不完整的轉換生成 ExternT 字元的終止字元序列
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 返回生成一個 InternT 字元所需的 ExternT 字元數（如果恆定）
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 測試 facet 是否為所有有效引數值編碼同一性轉換
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 計算轉換為給定 InternT 緩衝區時將消耗的 ExternT 字串的長度
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]
[virtual]
 返回可以轉換為單個 InternT 字元的最大 ExternT 字元數
(std::codecvt<InternT,ExternT,StateT> 的虛保護成員函式) [編輯]

繼承自 std::codecvt_base

巢狀型別 定義
enum result { ok, partial, error, noconv }; 無作用域列舉型別
列舉常量 定義
ok 轉換完成，無錯誤
部分 並非所有源字元都已轉換
error 遇到無效字元
noconv 無需轉換，輸入和輸出型別相同

[編輯] 示例

執行此程式碼
#include <cassert>
#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
 
int main()
{
    std::string u8 = "z\u00df\u6c34\U0001f34c";
    std::u16string u16 = u"z\u00df\u6c34\U0001f34c";
 
    // UTF-8 to UTF-16/char16_t
    std::u16string u16_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(u8);
    assert(u16 == u16_conv);
    std::cout << "UTF-8 to UTF-16 conversion produced " << u16_conv.size()
              << " code units:\n" << std::showbase << std::hex;
    for (char16_t c : u16_conv)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
 
    // UTF-16/char16_t to UTF-8
    std::string u8_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.to_bytes(u16);
    assert(u8 == u8_conv);
    std::cout << "\nUTF-16 to UTF-8 conversion produced "
              << std::dec << u8_conv.size() << " bytes:\n" << std::hex;
    for (char c : u8_conv)
        std::cout << +static_cast<unsigned char>(c) << ' ';
    std::cout << '\n';
}

輸出

UTF-8 to UTF-16 conversion produced 5 code units:
0x7a 0xdf 0x6c34 0xd83c 0xdf4c
UTF-16 to UTF-8 conversion produced 10 bytes:
0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c

[編輯] 缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告 應用於 釋出時的行為 正確的行為
LWG 2229 C++98 建構函式和解構函式未指定 指定它們

[編輯] 另請參閱

字元
轉換		 由區域設定定義的多位元組
(UTF-8, GB18030)		 UTF-8
 UTF-16
UTF-16 mbrtoc16 / c16rtomb (帶 C11 的 DR488)

codecvt<char16_t,char,mbstate_t>
codecvt_utf8_utf16<char16_t>
codecvt_utf8_utf16<char32_t>
codecvt_utf8_utf16<wchar_t>

 不適用
UCS-2 c16rtomb (不帶 C11 的 DR488) codecvt_utf8<char16_t> codecvt_utf16<char16_t>
UTF-32

mbrtoc32 / c32rtomb

codecvt<char32_t,char,mbstate_t>
codecvt_utf8<char32_t>

codecvt_utf16<char32_t>

系統 wchar_t

UTF-32 (非 Windows)
UCS-2 (Windows)

mbsrtowcs / wcsrtombs
use_facet<codecvt
<wchar_t,char,mbstate_t>>(locale)

 codecvt_utf8<wchar_t> codecvt_utf16<wchar_t>
 在字元編碼之間轉換，包括 UTF-8、UTF-16、UTF-32
(類模板) [編輯]
(C++11)(C++17 中已棄用)(C++26 中已移除)
 用於改變標準 codecvt 刻面行為的標籤
(列舉) [編輯]
(C++11)(C++17 中已棄用)(C++26 中已移除)
 在 UTF-8 和 UCS-2/UCS-4 之間轉換
(類模板) [編輯]
(C++11)(C++17 中已棄用)(C++26 中已移除)
 在 UTF-16 和 UCS-2/UCS-4 之間轉換
(類模板) [編輯]
取自 "https://cppreference.tw/mwiki/index.php?title=cpp/locale/codecvt_utf8_utf16&oldid=177707"