C 庫(kù)函數(shù) - mbstowcs()

C 標(biāo)準(zhǔn)庫(kù) - <stdlib.h> C 標(biāo)準(zhǔn)庫(kù) - <stdlib.h>

描述

C 庫(kù)函數(shù) size_t mbstowcs(schar_t *pwcs, const char *str, size_t n) 把參數(shù) str 所指向的多字節(jié)字符的字符串轉(zhuǎn)換為參數(shù) pwcs 所指向的數(shù)組。

聲明

下面是 mbstowcs() 函數(shù)的聲明。

size_t mbstowcs(schar_t *pwcs, const char *str, size_t n)

參數(shù)

  • pwcs -- 指向一個(gè) wchar_t 元素的數(shù)組，數(shù)組長(zhǎng)度足以存儲(chǔ)一個(gè)最大字符長(zhǎng)度的寬字符串。
  • str -- 要被轉(zhuǎn)換的多字節(jié)字符字符串。
  • n -- 要被轉(zhuǎn)換的最大字符數(shù)。

返回值

該函數(shù)返回轉(zhuǎn)換的字符數(shù)，不包括結(jié)尾的空字符。如果遇到一個(gè)無效的多字節(jié)字符，則返回 -1 值。

實(shí)例

下面的實(shí)例演示了 mbstowcs() 函數(shù)的用法。

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main()
{
   int len;
   char *pmbnull  = NULL;
   char *pmb = (char *)malloc( MB_CUR_MAX );
   wchar_t *pwc = L"Hi";
   wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));

   printf("轉(zhuǎn)換為多字節(jié)字符串\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("被轉(zhuǎn)換的字符 %d\n", len);
   printf("第一個(gè)多字節(jié)字符的十六進(jìn)制值：%#.4x\n", pmb);
   
   printf("轉(zhuǎn)換回寬字符字符串\n");
   len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
   printf("被轉(zhuǎn)換的字符 %d\n", len);
   printf("第一個(gè)寬字符的十六進(jìn)制值：%#.4x\n\n", pwcs);
   
   return(0);
}

讓我們編譯并運(yùn)行上面的程序，這將產(chǎn)生以下結(jié)果：

轉(zhuǎn)換為多字節(jié)字符串
被轉(zhuǎn)換的字符 1
第一個(gè)多字節(jié)字符的十六進(jìn)制值：0x19a60010
轉(zhuǎn)換回寬字符字符串
被轉(zhuǎn)換的字符 1
第一個(gè)寬字符的十六進(jìn)制值：0x19a60030

C 標(biāo)準(zhǔn)庫(kù) - <stdlib.h> C 標(biāo)準(zhǔn)庫(kù) - <stdlib.h>