Subroutine mbsinit

Zweck

Status des Konvertierungsobjekts bestimmen.

Bibliothek

Standardbibliothek (libc.a)

Syntax

#include <wchar.h>

int mbsinit (const mbstate_t * ps) ;

Beschreibung

Wenn ps kein Nullzeiger ist, bestimmt die Funktion mbsinit , ob das Objekt, auf das ps verweist, einen anfänglichen Konvertierungsstatus beschreibt.

Das Objekt mbstate_t wird verwendet, um den aktuellen Konvertierungsstatus aus einer bestimmten Zeichenfolge in eine Breitzeichenfolge (oder umgekehrt) unter den Regeln einer bestimmten Einstellung der Kategorie LC_CTYPE der aktuellen Ländereinstellung zu beschreiben.

Der ursprüngliche Umsetzungszustand entspricht bei einer Umsetzung in beide Richtungen dem Beginn einer neuen Zeichenfolge im ursprünglichen Schaltzustand. Ein mbstate_t -Objekt mit einem Nullwert ist mindestens eine Möglichkeit, einen Anfangskonvertierungsstatus zu beschreiben. Ein mbstate_t -Objekt mit einem Nullwert kann verwendet werden, um die Konvertierung mit einer beliebigen Zeichenfolge in einer beliebigen Kategorieeinstellung LC_CTYPE einzuleiten.

Rückgabewerte

Die Funktion mbsinit gibt einen Wert ungleich null zurück, wenn ps ein Nullzeiger ist oder wenn das Objekt, auf das verwiesen wird, einen anfänglichen Konvertierungsstatus beschreibt. Andernfalls wird null zurückgegeben.

Wenn ein mbstate_t -Objekt von einer der Funktionen geändert wird, die alsrestartable, und wird dann mit einer anderen Zeichenfolge oder in der anderen Konvertierungsrichtung oder mit einer anderen Kategorieeinstellung LC_CTYPE als bei früheren Funktionsaufrufen verwendet, ist das Verhalten nicht definiert.