wctob

Artikel
02/26/2013

Bestimmt, ob ein Breitzeichen zu einem Mehrbytezeichen entspricht und dessen Darstellung Mehrbytezeichen zurückgibt.

int wctob(
   wint_t wchar
);

Parameter

wchar
So übersetzender Wert.

Rückgabewert

Wenn wctob erfolgreich ein Breitzeichen konvertiert, gibt es seine Darstellung Mehrbytezeichen nur zurück, wenn das Mehrbytezeichen genau ein Byte lang ist.Wenn ein Breitzeichen trifft, wctob nicht auf einen Mehrbytezeichen konvertieren kann, oder das Mehrbytezeichen nicht genau ein Byte lang ist, gibt es eine 1 zurück.

Hinweise

Die wctob-Funktion konvertiert ein Breitzeichen, die in wchar dem entsprechenden Mehrbytezeichen enthalten ist, der durch den übergebenen Wert zurückgeben int Mehrbytezeichen, wenn das genau ein Byte lang ist.

Wenn wctob nicht erfolgreich war und kein entsprechendes Mehrbytezeichen gefunden wurde, legt die Funktion errno zu EILSEQ fest und gibt -1 zurück.

Anforderungen

Routine	Erforderlicher Header
wctob	<wchar.h>

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

Beispiel

Dieses Programm wird das Verhalten der wcstombs-Funktion.

// 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);
    }
}