mbrtowc即指轉換一個字元到寬字元形式。
基本介紹
- 中文名：mbrtowc
- 概述：轉換一個字元到寬字元形式
- 聲明：#include <wchar.h>
- 描述：功能應調用等效
概述,聲明,描述,返回值,
概述
mbrtowc - 轉換一個字元到寬字元形式。（可重啟）
聲明
#include <wchar.h>
size_t mbrtowc(wchar_t *restrictpwc, const char *restricts,
size_tn, mbstate_t *restrictps);
描述
如果s是一個空指針，mbrtowc功能應調用等效的：
mbrtowc(NULL, "", 1, ps)
在這種情況下，pwc和n的值參數將被忽略。
如果s不是一個空指針，mbrtowc功能應當檢查所指向的位元組的n個位元組開始大多是來確定所需的位元組數完成包括任何變化的下一個字元序列。如果完成下一個字元的函式確定的，應當確定相應寬字元的值，然後，如果預委會不是一個空指針，將該值存儲在預委會指向的對象。如果相應範圍的字元是空寬字元，結果狀態描述應初始轉換狀態。
如果p是一個空指針，mbrtowc函式將使用其內部mbstate_t對象，應在起動程式初始化初始轉換狀態。否則，mbstate_t指向的對象ps完全描述，必須使用當前轉換字元序列相關聯的狀態。如果此卷中定義的任何函式mbrtowcieee標準1003.1-2001個電話，實現應表現為。
此函式的行為是受lc_ctype類別的當前區域設定。
返回值
mbrtowc下列函式將返回第一個適用於：
0 如果對應的下一個n或更少的完整的位元組字元存儲的值的空寬字元。
1-n 如果未來n或更少的位元組存儲的值的完整有效的字元；返回的值應完成字元的位元組數。
-2 如果未來n位元組的貢獻不完整，但可能會有效字元，並處理所有n個位元組存儲任何值。在n至少值{mb_cur_max}宏時，如果序列點與國家相關的編碼實現冗餘序列轉變，這種情況下只能發生。
-1 如果出現編碼錯誤，在這種情況下，未來n或更少無助的完整和有效的字元的位元組存儲任何值。在這種情況下，[eilseq]應存儲在errno和未定義的轉換狀態。
