_setmbcp

  • Artikel

Legt eine neue Multibyte-Codepage fest.

Syntax

int _setmbcp(
   int codepage
);

Parameter

codepage
Neue Codepageeinstellung für gebietsschemaunabhängige Multibyte-Routinen.

Rückgabewert

Gibt 0 zurück, wenn die Codepage erfolgreich festgelegt wurde. Wenn für einen ungültigen Codeseitenwert angegeben wird, wird -1 zurückgegeben codepage, und die Codeseiteneinstellung ist unverändert. Legt errno auf EINVAL fest, wenn ein Fehler beim Reservieren von Speicher auftritt.

Hinweise

Die _setmbcp-Funktion legt eine neue Multibyte-Codepage fest. Standardmäßig legt das Laufzeitsystem automatisch die Multibyte-Codepage auf die Systemstandard-ANSI-Codepage fest. Die Multibyte-Codepageeinstellung wirkt sich auf alle Multibyte-Routinen aus, die nicht vom Gebietsschema abhängig sind. Es ist jedoch möglich _setmbcp , die für das aktuelle Gebietsschema definierte Codeseite zu verwenden (siehe die folgende Liste der Manifestkonstanten und zugehörigen Verhaltensergebnisse). Eine Liste der Multibyte-Routinen, die von der Gebietsschemacodeseite und nicht von der Multibyte-Codeseite abhängig sind, finden Sie unter Interpretation von Multibyte-Zeichensequenzen.

Das codepage-Argument kann auf einen der folgenden Werte festgelegt werden:

  • _MB_CP_ANSI Verwenden Sie die vom Betriebssystem beim Programmstart abgerufene ANSI-Codepage.

  • _MB_CP_LOCALE Verwenden Sie die Codepage des aktuellen Gebietsschemas, die aus einem vorherigen Aufruf von setlocale.

  • _MB_CP_OEM Verwenden Sie die vom Betriebssystem beim Programmstart abgerufene OEM-Codepage.

  • _MB_CP_SBCS Verwenden Sie eine Einzelbyte-Codepage. Wenn die Codepage auf _MB_CP_SBCS"false" festgelegt ist, gibt eine Routine wie _ismbblead z. B. immer "false" zurück.

  • _MB_CP_UTF8 Verwenden Sie UTF-8. Wenn die Codepage auf _MB_CP_UTF8"false" festgelegt ist, gibt eine Routine wie _ismbblead z. B. immer "false" zurück.

  • Alle anderen gültigen Codeseitenwerte, unabhängig davon, ob es sich bei dem Wert um eine ANSI-, OEM- oder andere vom Betriebssystem unterstützte Codeseite handelt (mit Ausnahme von UTF-7, die nicht unterstützt wird).

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
_setmbcp <mbctype.h>

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

Siehe auch

_getmbcp
setlocale, _wsetlocale