Sdílet prostřednictvím

_setmbcp

  • Článek

Nastaví novou vícebajtovou znakovou stránku.

Syntaxe

int _setmbcp(
   int codepage
);

Parametry

codepage
Nové nastavení znakové stránky pro rutiny s vícebajty nezávislými na národním prostředí

Vrácená hodnota

Vrátí hodnotu 0, pokud je znaková stránka úspěšně nastavena. Pokud je zadána codepageneplatná hodnota znakové stránky , vrátí hodnotu -1 a nastavení znakové stránky se nezmění. Nastaví errno , EINVAL pokud dojde k selhání přidělení paměti.

Poznámky

Funkce _setmbcp určuje novou vícebajtovou znakovou stránku. Ve výchozím nastavení systém runtime automaticky nastaví vícebajtovou znakovou stránku na výchozí znakovou stránku SYSTÉMU ANSI. Nastavení vícebajtové znakové stránky má vliv na všechny rutiny s vícebajty, které nejsou závislé na národním prostředí. Je ale možné dát pokyn _setmbcp použít znakovou stránku definovanou pro aktuální národní prostředí (viz následující seznam konstant manifestu a souvisejících výsledků chování). Seznam vícebajtových rutin, které jsou závislé na znakové stránce národního prostředí místo vícebajtové znakové stránky, naleznete v tématu Interpretace vícebajtových sekvencí znaků.

Argument codepage lze nastavit na některou z následujících hodnot:

  • _MB_CP_ANSI Při spuštění programu použijte znakovou stránku ANSI získanou z operačního systému.

  • _MB_CP_LOCALE Použijte znakovou stránku aktuálního národního prostředí získanou z předchozího volání setlocale.

  • _MB_CP_OEM Při spuštění programu použijte znakovou stránku OEM získanou z operačního systému.

  • _MB_CP_SBCS Použijte znakovou stránku s jedním bajtem. Pokud je znaková stránka nastavena na _MB_CP_SBCS, rutina, jako _ismbblead je například vždy vrátí hodnotu false.

  • _MB_CP_UTF8 Použijte UTF-8. Pokud je znaková stránka nastavena na _MB_CP_UTF8, rutina, jako _ismbblead je například vždy vrátí hodnotu false.

  • Jakákoli jiná platná hodnota znakové stránky bez ohledu na to, jestli se jedná o hodnotu ANSI, OEM nebo jinou znakovou stránku podporovanou operačním systémem (s výjimkou UTF-7, která není podporovaná).

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina Požadovaný hlavičkový soubor
_setmbcp <mbctype.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

_getmbcp
setlocale, _wsetlocale