wctob

發行項
06/09/2015

判斷寬字元是否符合多位元組字元並以它的多位元組字元表示法傳回。

int wctob(
   wint_t wchar
);

參數

wchar
要轉換的值。

傳回值

如果 wctob 成功轉換為寬字元，則它會傳回其多位元組字元表示，只有在多位元組字元完全是位元組。如果wctob遇到無法轉換成多位元組字元或是多字員組字元不是恰好長度為一個位元組的寬字元，則會回傳-1。

備註

如果多位元組字元長度恰為一位元組，則wctob函式轉換一個包含在wchar的以int值回傳的寬字元為多位元組字元。

如果 wctob 不成功，也找不到對應的多位元組字元，則函式會將errno 設定為 EILSEQ 並傳回 -1。

需求

常式	必要的標頭
wctob	<wchar.h>

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

範例

這個程式說明 wcstombs 函式的行為。

// crt_wctob.c
#include <stdio.h>
#include <wchar.h>

int main( void )
{
    int     bChar = 0;
    wint_t  wChar = 0;

    // Set the corresponding wide character to exactly one byte.
    wChar = (wint_t)'A';

    bChar = wctob( wChar );
    if (bChar == WEOF)
    {
        printf( "No corresponding multibyte character was found.\n");
    }
    else
    {
        printf( "Determined the corresponding multibyte character to"
                " be \"%c\".\n", bChar);
    }
}