_setmbcp

Ustawia nową stronę kodu wielobajtowego.

Składnia

int _setmbcp(
   int codepage
);

Parametry

codepage
Nowe ustawienie strony kodowej dla procedur wielobajtowych niezależnych od ustawień regionalnych.

Wartość zwracana

Zwraca wartość 0, jeśli strona kodowa została pomyślnie ustawiona. Jeśli podano nieprawidłową wartość strony kodowej dla codepageparametru , zwraca wartość -1, a ustawienie strony kodowej nie zmienia się. Ustawia errno wartość , EINVAL jeśli wystąpi błąd alokacji pamięci.

Uwagi

Funkcja _setmbcp określa nową stronę kodu wielobajtowego. Domyślnie system czasu wykonywania automatycznie ustawia stronę kodu wielobajtowego na domyślną stronę kodową ANSI systemu. Ustawienie wielobajtowej strony kodu wpływa na wszystkie procedury wielobajtowe, które nie są zależne od ustawień regionalnych. Można jednak poinstruować _setmbcp użycie strony kodowej zdefiniowanej dla bieżących ustawień regionalnych (zobacz poniższą listę stałych manifestu i skojarzonych wyników zachowania). Aby uzyskać listę procedur wielobajtowych, które są zależne od strony kodu ustawień regionalnych, a nie strony kodu wielobajtowego, zobacz Interpretacja sekwencji wielobajtowych znaków.

Argument codepage można ustawić na dowolną z następujących wartości:

  • _MB_CP_ANSI Użyj strony kodowej ANSI uzyskanej z systemu operacyjnego podczas uruchamiania programu.

  • _MB_CP_LOCALEUżyj strony kodowej bieżącego ustawienia regionalnego uzyskanej z poprzedniego wywołania metody .setlocale

  • _MB_CP_OEM Użyj strony kodowej OEM uzyskanej z systemu operacyjnego podczas uruchamiania programu.

  • _MB_CP_SBCS Użyj strony kodowej z jednym bajtem. Gdy strona kodowa jest ustawiona na _MB_CP_SBCSwartość , rutyna taka jak _ismbblead zawsze zwraca wartość false.

  • _MB_CP_UTF8 Użyj protokołu UTF-8. Gdy strona kodowa jest ustawiona na _MB_CP_UTF8wartość , rutyna taka jak _ismbblead zawsze zwraca wartość false.

  • Każda inna prawidłowa wartość strony kodowej, niezależnie od tego, czy wartość jest anSI, OEM lub inną stroną kodową obsługiwaną przez system operacyjny (z wyjątkiem utF-7, która nie jest obsługiwana).

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Procedura Wymagany nagłówek
_setmbcp <mbctype.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

_getmbcp
setlocale, _wsetlocale