_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> |
Дополнительные сведения о совместимости см. в разделе Совместимость.