wctob

Article
06/09/2015

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

int wctob(
   wint_t wchar
);

Paramètres

wchar
+Valeur à convertir.

Valeur de retour

Si wctob convertit correctement un caractère large, elle retourne la représentation de caractères multioctets, uniquement si le caractères multioctets est exactement dee longueur un octet. Si wctob rencontre un caractère large qu'ilil ne peut pas convertir en caractères multioctets ou que le caractère multioctet n'est pas exactement d'un octet, il retourne -1.

Notes

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

Si wctob est é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 plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Exemple

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