_setmbcp

Задает новую многобайтовую кодовую страницу.

Синтаксис

int _setmbcp(
   int codepage
);

Параметры

codepage
Новая кодовая страница для независимых от языкового стандарта многобайтовых подпрограмм.

Возвращаемое значение

Возвращает 0, если кодовая страница задана успешно. Если задано codepageнедопустимое значение кодовой страницы, возвращает значение -1 и параметр кодовой страницы не изменяется. Устанавливает параметр errno в EINVAL, если происходит сбой выделения памяти.

Замечания

Функция _setmbcp задает новую многобайтовую кодовую страницу. По умолчанию система времени выполнения автоматически устанавливает в качестве многобайтовой кодовой страницы кодовую страницу ANSI, используемую в системе по умолчанию. Параметр многобайтовой кодовой страницы влияет на все многобайтовые подпрограммы, которые не зависят от языкового стандарта. Однако можно указать _setmbcp использовать кодовую страницу, определенную для текущего языкового стандарта (см. следующий список констант манифеста и связанные результаты поведения). Список многобайтовых подпрограмм, зависящих от кодовой страницы языкового стандарта, а не многобайтовой кодовой страницы, см. в разделе "Интерпретация последовательностей многобайтовых символов".

Для аргумента codepage может быть установлено одно из следующих значений:

• _MB_CP_ANSI Используется кодовая страница ANSI, полученная от операционной системы при запуске программы.

• _MB_CP_LOCALE Используйте кодовую страницу текущего языкового стандарта, полученную из предыдущего вызова setlocale.

• _MB_CP_OEM Используется кодовая страница OEM, полученная от операционной системы при запуске программы.

• _MB_CP_SBCS Используется однобайтовая кодовая страница. Если задано значение _MB_CP_SBCSкодовой страницы, подпрограмма, например _ismbblead всегда возвращает значение false.

• _MB_CP_UTF8 Используйте UTF-8. Если задано значение _MB_CP_UTF8кодовой страницы, подпрограмма, например _ismbblead всегда возвращает значение false.

• Любое другое допустимое значение кодовой страницы независимо от того, является ли значение ANSI, OEM или другой поддерживаемой операционной системой кодовой странице (за исключением UTF-7, которая не поддерживается).

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут	Обязательный заголовок
_setmbcp	<mbctype.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

_getmbcp
setlocale, _wsetlocale