wctob

Articolo
06/09/2015

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

int wctob(
   wint_t wchar
);

Parametri

wchar
Valore da convertire.

Valore restituito

Se wctob converte correttamente un carattere wide, restituisce la rappresentazione in caratteri multibyte solo se il carattere multibyte è lungo esattamente un byte. Se wctob rileva un carattere wide, non può effettuare la conversione in caratteri multibyte o il carattere multibyte non è lungo esattamente un byte, restituisce un - 1.

Note

La funzione wctob converte un carattere wide contenuto in wchar nel carattere multibyte corrispondente passato dal valore di ritorno int, se il carattere multibyte è lungo esattamente un byte.

Se wctob non è riuscita e nessun carattere multibyte corrispondente è stato trovato, la funzione imposta errno a EILSEQ e restituisce -1.

Requisiti

Routine	Intestazione obbligatoria
wctob	<wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Esempio

Questo programma mostra il comportamento della funzione 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);
    }
}