mbtowc

在標頭檔案 `<stdlib.h>` 中定義
int mbtowc( wchar_t* pwc, const char* s, size_t n )		(直到 C99)
int mbtowc( wchar_t* restrict pwc, const char* restrict s, size_t n )		(C99 起)

將第一個位元組由 s 指向的多位元組字元轉換為寬字元，如果 pwc 不為空，則寫入 *pwc。

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

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

[編輯] 引數

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

[編輯] 返回值

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

如果 s 是空指標，則將其內部轉換狀態重置為初始移位狀態，如果當前多位元組編碼與狀態無關（不使用移位序列），則返回 0；如果當前多位元組編碼與狀態相關（使用移位序列），則返回非零值。

[編輯] 示例

執行此程式碼

#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <wchar.h>
 
// print multibyte string to wide-oriented stdout
// equivalent to wprintf(L"%s\n", ptr);
void print_mb(const char* ptr)
{
    mbtowc(NULL, NULL, 0); // reset the conversion state
    const char* end = ptr + strlen(ptr);
    int ret = 0;
    for (wchar_t wc; (ret = mbtowc(&wc, ptr, end - ptr)) > 0; ptr += ret)
        wprintf(L"%lc", wc);
    wprintf(L"\n");
}
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    print_mb("z\u00df\u6c34\U0001F34C"); // or "zß水🍌"
}

輸出

zß水🍌

[編輯] 參考

C23 標準 (ISO/IEC 9899:2024)

7.24.7.2 mbtowc 函式 (p: TBD)

C17 標準 (ISO/IEC 9899:2018)

7.22.7.2 mbtowc 函式 (p: 260)

C11 標準 (ISO/IEC 9899:2011)

7.22.7.2 mbtowc 函式 (p: 358)

C99 標準 (ISO/IEC 9899:1999)

7.20.7.2 mbtowc 函式 (p: 322)

C89/C90 標準 (ISO/IEC 9899:1990)

4.10.7.2 mbtowc 函式

[編輯] 另請參閱

mbrtowc (C95)	將下一個多位元組字元轉換為寬字元，給定狀態 (函式) [編輯]
mblen	返回下一個多位元組字元的位元組數 (函式) [編輯]
C++ 文件關於 mbtowc

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

cppreference.com

名稱空間

變體

檢視

操作