mbrtoc32

在標頭檔案 `<uchar.h>` 中定義
size_t mbrtoc32( char32_t restrict* pc32, const char* restrict s, size_t n, mbstate_t* restrict ps );		(C11 起)

將一個窄多位元組字元表示中的單一碼位轉換為其可變長 32 位寬字元表示（但通常是 UTF-32）。

若 s 非空指標，則檢查至多 n 位元組的多位元組字元字串，從 s 所指向的位元組開始，以確定完成下一個多位元組字元所需的位元組數（包括任何移位序列，並考慮當前的多位元組轉換狀態 *ps）。若函式確定 s 中的下一個多位元組字元完整且有效，則將其轉換為對應的 32 位寬字元並存儲到 *pc32（若 pc32 非空）。

若 *s 中的多位元組字元對應多 char32_t 序列（對於 UTF-32 不可能），則在此函式首次呼叫後，會更新 *ps，使得後續對 mbrtoc32 的呼叫將寫入額外的 char32_t，而不考慮 *s。

若 s 為空指標，則忽略 n 和 pc32 的值，且呼叫等價於 mbrtoc32(NULL, "", 1, ps)。

若產生的寬字元是空字元，則轉換狀態 *ps 代表初始移位狀態。

若定義了宏 __STDC_UTF_32__，則此函式使用的 32 位編碼是 UTF-32；否則，它是實現定義的。此宏總是定義的，且編碼總是 UTF-32。(C23 起) 無論如何，此函式使用的多位元組字元編碼由當前活躍的 C 語言環境指定。

0 若從 s 轉換的字元（若非空則儲存在 *pc32 中）是空字元。
從 s 成功轉換的多位元組字元的位元組數 [1, n]。
(size_t)-3 若多 char32_t 字元的下一個 char32_t 已寫入 *pc32。此情況下不處理輸入中的位元組。
(size_t)-2 若接下來的 n 位元組構成一個不完整但目前為止有效的多位元組字元。不向 *pc32 寫入任何內容。
(size_t)-1 若發生編碼錯誤。不向 *pc32 寫入任何內容，值 EILSEQ 儲存於 errno 中，且 *ps 的值未指定。

[編輯] 示例

在 MSVC 上，你需要 /utf-8 編譯器標誌以使 UTF-8 正常工作。

執行此程式碼

#include <assert.h>
#include <locale.h>
#include <stdio.h>
#include <uchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    char in[] = u8"zß水🍌"; // or "z\u00df\u6c34\U0001F34C"
    enum { in_size = sizeof in / sizeof *in };
 
    printf("Processing %d UTF-8 code units: [", in_size);
    for (int i = 0; i < in_size; ++i)
        printf("%s%02X", i ? " " : "", (unsigned char)in[i]);
    puts("]");
 
    char32_t out[in_size];
    char32_t* p_out = out;
    char* p_in = in;
    char* end = in + in_size;
    mbstate_t state = {0};
    size_t rc;
    while ((rc = mbrtoc32(p_out, p_in, end - p_in, &state)))
    {
        assert(rc != (size_t)-3); // no surrogate pairs in UTF-32
        if (rc == (size_t)-1) break; // invalid input
        if (rc == (size_t)-2) break; // truncated input
        p_in += rc;
        ++p_out;
    }
 
    size_t out_size = p_out+1 - out;
    printf("into %zu UTF-32 code units: [", out_size);
    for (size_t i = 0; i < out_size; ++i)
        printf("%s%08X", i ? " " : "", out[i]);
    puts("]");
}

輸出

Processing 11 UTF-8 code units: [7A C3 9F E6 B0 B4 F0 9F 8D 8C 00]
into 5 UTF-32 code units: [0000007A 000000DF 00006C34 0001F34C 00000000]

[編輯] 參考

C23 標準 (ISO/IEC 9899:2024)

7.30.1.5 函式 mbrtoc32 (p: 410)

C17 標準 (ISO/IEC 9899:2018)

7.28.1.3 函式 mbrtoc32 (p: 293-294)

C11 標準 (ISO/IEC 9899:2011)

7.28.1.3 函式 mbrtoc32 (p: 400-401)

[編輯] 亦參見

c32rtomb (C11)	將 UTF-32 字元轉換為窄多位元組編碼 (函式) [編輯]
C++ 文件用於 mbrtoc32

編譯器支援
語言
標頭檔案
型別支援
程式工具
變參函式支援
錯誤處理
動態記憶體管理
字串庫
演算法
數值
日期和時間工具
輸入/輸出支援
本地化支援
併發支援 (C11)
技術規範
符號索引

pc32	-	指向寫入結果 32 位寬字元的位置的指標
s	-	指向用作輸入的多位元組字元字串的指標
n	-	s 中可檢查的位元組數的限制
ps	-	指向轉換狀態物件的指標，用於解釋多位元組字串

cppreference.com

名稱空間

變體

檢視

操作

mbrtoc32

目錄

[編輯] 引數

[編輯] 返回值

[編輯] 示例

[編輯] 參考

[編輯] 亦參見

導航

工具箱