wctob

Bestimmt, ob ein Breitzeichen einem Multibytezeichen entspricht und gibt dessen Multibytezeichen-Darstellung zurück.

Syntax

int wctob(
   wint_t wchar
);

Parameter

wchar
Zu übersetzender Wert.

Rückgabewert

Wenn wctob ein breites Zeichen erfolgreich konvertiert wird, wird die Multibyte-Zeichendarstellung nur zurückgegeben, wenn das Multibyte-Zeichen ein einzelnes Byte lang ist. Wenn wctob ein breites Zeichen auftritt, kann es nicht in ein Multibyte-Zeichen konvertiert werden, oder wenn das Multibyte-Zeichen kein einzelnes Byte lang ist, wird -1 zurückgegeben.

Hinweise

Die wctob Funktion konvertiert ein breites Zeichen, das in wchar dem entsprechenden Multibyte-Zeichen enthalten ist, das int vom Rückgabewert übergeben wird, wenn das Multibyte-Zeichen ein einzelnes Byte lang ist.

Wenn wctob nicht erfolgreich war und kein entsprechendes Multibytezeichen erkannt wurde, legt die Funktion errno auf EILSEQ fest und gibt -1 zurück.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Dieses Programm stellt das Verhalten der Funktion wctob dar.

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

Siehe auch

Datenkonvertierung
Gebietsschema
_mbclen, mblen_mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wctomb, _wctomb_l
WideCharToMultiByte