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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine	Erforderlicher Header
wctob	<wchar.h>

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