wctob

Artikel
06/09/2015

Bestimmt, ob ein Breitzeichen einem Mehrbytezeichen entspricht und seiner Mehrbytezeichendarstellung zurückgibt.

int wctob(
   wint_t wchar
);

Parameter

wchar
So übersetzender Wert.

Rückgabewert

Wenn wctob erfolgreich ein Breitzeichen konvertiert, gibt es die Mehrbytezeichendarstellung, nur zurück, wenn das Mehrbytezeichen genau ein Byte lange dauern. Wenn wctob ein Breitzeichen trifft, das er nicht auf einen Mehrbytezeichen konvertieren kann, oder das Mehrbytezeichen nicht genau ein Byte lange ist, gibt es a - 1 zurück.

Hinweise

Die wctob-Funktion konvertiert ein Breitzeichen, das in wchar zum entsprechenden Mehrbytezeichen enthalten ist, das vom Rückhol- int-Wert übergeben wird, wenn das Mehrbytezeichen genau ein Byte lange dauern.

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

Anforderungen

Routine	Erforderlicher Header
wctob	<wchar.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

Dieses Programm veranschaulicht das Verhalten der Funktion 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);
    }
}