wctob

Determina se un carattere wide corrisponde a un carattere multibyte e restituisce la sua rappresentazione in caratteri multibyte.

Sintassi

int wctob(
   wint_t wchar
);

Parametri

wchar
Valore da convertire.

Valore restituito

Se wctob converte correttamente un carattere wide, restituisce la relativa rappresentazione di caratteri multibyte solo se il carattere multibyte è un singolo byte long. Se wctob rileva un carattere wide, non può convertire in un carattere multibyte o se il carattere multibyte non è un singolo byte lungo, restituisce -1.

Osservazioni:

La wctob funzione converte un carattere wide contenuto in nel wchar carattere multibyte corrispondente passato dal int valore restituito, se il carattere multibyte è un singolo byte long.

Se wctob ha avuto esito negativo e nessun carattere multibyte corrispondente è stato trovato, la funzione imposta errno su EILSEQ e restituisce -1.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria
wctob	<wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Questo programma illustra il comportamento della funzione wctob.

// 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".

Vedi anche

Conversione dei dati
impostazioni locali
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte