wctob

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

Syntaxe

int wctob(
   wint_t wchar
);

Paramètres

wchar
Valeur à traduire.

Valeur retournée

Si wctob elle convertit correctement un caractère large, elle retourne sa représentation de caractères multioctets uniquement si le caractère multioctet est un seul octet long. Si wctob vous rencontrez un caractère large, il ne peut pas convertir en caractère multioctet, ou si le caractère multioctet n’est pas un seul octet, il retourne -1.

Notes

La wctob fonction convertit un caractère large contenu dans wchar le caractère multioctet correspondant passé par la int valeur de retour, si le caractère multioctet est un octet unique long.

Si wctob a échoué et qu’aucun caractère multioctet correspondant n’a été trouvé, la fonction affecte à errno la valeur EILSEQ et retourne -1.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Routine	En-tête requis
wctob	<wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Ce programme illustre le comportement de la fonction 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".

Voir aussi

Conversion de données
Paramètres régionaux
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte