mbtowc

C語言的一個庫函式，包含在<stdlib.h>中，用來把一個多位元組序列轉換為一個寬字元。

基本介紹

• 類型：C語言編程函式
• 類別：計算機編程技術

概述

#include<stdlib.h>

int mbtowc(wchar_t *pwc, const char *s, size_t n)

說明

如果s不是空指針，函式mbtowc確定s指向的多位元組字元中包含的位元組數，然後確定和這個多位元組字元對應的wchar_t類型的值的編碼。（和空字元對應的編碼值為零）如果多位元組字元有效且pwc不為空，mbtowc函式就把編碼值存儲在pwc指向的對象中，n表示可以檢測s指向的數組中的最大的數，不能超過MB_CUR_MAX。

返回值

如果s是空指針，多位元組字元編碼是狀態相關的函式返回非零值，如果多位元組字元編碼狀態是不相關的則返回零。如果s非空，如果s指向空字元，則返回零，否則，返回多位元組字元中包含的位元組數。如果指向的位置的元素不能組成一個有效的多位元組字元或者出錯，返回-1；