wctob

Article
03/04/2013

Détermine si un caractère élargi correspond à un caractère multioctets et retourne sa représentation de caractères multioctets.

int wctob(
   wint_t wchar
);

Paramètres

wchar
valeur à traduire.

Valeur de retour

Si wctob convertit correctement un caractère élargi, il retourne sa représentation de caractères multioctets, uniquement si le caractère multioctets est exactement d'un octet long.Si wctob rencontre un caractère élargi qu'il ne peut pas convertir en un caractère multioctets ou un caractère multioctets n'est pas exactement d'un octet long, il retourne une valeur.

Notes

La fonction d' wctob convertit un caractère élargi contenu dans wchar au caractère multioctets correspondant passé par la valeur de retour d' int , si le caractère multioctets est exactement d'un octet long.

Si wctob échec et aucun caractère multioctets correspondant n'a été trouvé, la fonction définit errno à EILSEQ et retourne -1.

Configuration requise

routine	en-tête requis
wctob	<wchar.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

Exemple

ce programme illustre le comportement de la fonction d' 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);
    }
}