mbtowc _mbtowc_l

發行項
02/28/2013

將多位元組字元轉換成相對應的寬字元中。

int mbtowc(
   wchar_t *wchar,
   const char *mbchar,
   size_t count 
);
int _mbtowc_l(
   wchar_t *wchar,
   const char *mbchar,
   size_t count,
   _locale_t locale
);

參數

wchar
寬字元的位址 (型別wchar_t)。
mbchar
一連串的位元組 (多位元組字元) 的地址。
計數
若要檢查的位元組數目。
地區設定
若要使用地區設定。

傳回值

如果 mbchar 不是 NULL 則為由右物件的mbchar指向表單是有效的多位元組字元， mbtowc傳回以位元組為單位的多位元組字元的長度。如果mbchar是 NULL 或其指向的物件是寬字元 null 字元 ('\ 0' L)、函式會傳回 0。如果物件的mbchar來點不會構成有效的多位元組字元，在第一個計數個字元，則會傳回 – 1。

備註

mbtowc函式會將計數或所指向的位元組較少mbchar，如果mbchar不是 NULL，以對應的寬字元。 mbtowc儲存結果的寬字元，在 wchar， 如果 wchar 不是 NULL。 mbtowc並不會檢查多個MB_CUR_MAX個位元組。 mbtowc使用目前的地區設定的地區設定相關的行為。 _mbtowc_l不同之處在於它所使用的地區設定中傳遞，則是完全相同。如需詳細資訊，請參閱地區設定。

需求

常式	所需的標頭
mbtowc	<stdlib.h>
_mbtowc_l	<stdlib.h>

其他的相容性資訊，請參閱相容性在簡介中。

文件庫

所有版本的 C 執行階段程式庫。

範例

// crt_mbtowc.c
/* Illustrates the behavior of the mbtowc function
 */

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

int main( void )
{
    int      i;
    char    *pmbc    = (char *)malloc( sizeof( char ) );
    wchar_t  wc      = L'a';
    wchar_t *pwcnull = NULL;
    wchar_t *pwc     = (wchar_t *)malloc( sizeof( wchar_t ) );
    printf( "Convert a wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "  Characters converted: %u\n", i );
    printf( "  Multibyte character: %x\n\n", *pmbc );

    printf( "Convert multibyte character back to a wide "
            "character:\n" );
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
    printf( "  Wide character: %x\n\n", *pwc );
    printf( "Attempt to convert when target is NULL\n" );
    printf( "  returns the length of the multibyte character:\n" );
    i = mbtowc( pwcnull, pmbc, MB_CUR_MAX );
    printf( "  Length of multibyte character: %u\n\n", i );

    printf( "Attempt to convert a NULL pointer to a" );
    printf( " wide character:\n" );
    pmbc = NULL;
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
}

Output

Convert a wide character to multibyte character:
  Characters converted: 1
  Multibyte character: 61

Convert multibyte character back to a wide character:
  Bytes converted: 1
  Wide character: 61

Attempt to convert when target is NULL
  returns the length of the multibyte character:
  Length of multibyte character: 1

Attempt to convert a NULL pointer to a wide character:
  Bytes converted: 0