`wctob`

Artikel
10/12/2023

Menentukan apakah karakter lebar sesuai dengan karakter multibyte dan mengembalikan representasi karakter multibyte-nya.

Sintaks

int wctob(
   wint_t wchar
);

Parameter

wchar
Nilai yang akan diterjemahkan.

Nilai hasil

Jika wctob berhasil mengonversi karakter lebar, karakter tersebut mengembalikan representasi karakter multibyte hanya jika karakter multibyte adalah satu byte panjang. Jika wctob menemukan karakter lebar, karakter tersebut tidak dapat dikonversi ke karakter multibyte, atau jika karakter multibyte bukan satu byte panjang, karakter tersebut mengembalikan -1.

Keterangan

Fungsi mengonversi wctob karakter lebar yang terkandung dalam ke karakter multibyte yang sesuai yang diteruskan wchar oleh int nilai pengembalian, jika karakter multibyte adalah satu byte panjang.

Jika wctob tidak berhasil dan tidak ada karakter multibyte yang sesuai yang ditemukan, fungsi diatur errno ke EILSEQ dan mengembalikan -1.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan
`wctob`	<wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Program ini menggambarkan perilaku wctob fungsi.

// 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);
    }
}

Determined the corresponding multibyte character to be "A".