Функция SetConsoleOutputCP

Функция SetConsoleOutputCP устанавливает кодовую страницу вывода данных, используемую консолью, связанной с вызывающим процессом. Консоль использует свою кодовую страницу вывода данных, чтобы преобразовать символьные значения, написанные различными функциями вывода информации в изображение, показываемое на экране в консольном окне.

Синтаксис

BOOL SetConsoleOutputCP(

    UINT wCodePageID    // кодовая страница

);

Параметры

wCodePageID

[in] Идентификатор кодовой страницы, которая устанавливается. Идентификаторы кодовых страниц, доступных на локальном компьютере сохраняются в системном реестре под нижеследующим ключом.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

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

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию GetLastError.

Замечания

Кодовая страница преобразует 256 кодов букв в индивидуальные символы. Разные кодовые страницы включают в себя разные специальные символы, обычно настраиваемые для языка или группы языков. Если текущий шрифт - моноширинный шрифт Уникода, функция SetConsoleOutputCP изменяет начертание символьных значений в установку глифов шрифта, а не загружает отдельный шрифт каждый раз, когда он вызывается. Это влияет на образ расширенных символов (значение ASCII больше, чем 127), которые отображаются в консольном окне. Однако, если текущий шрифт является растровым шрифтом, SetConsoleOutputCP не влияет на то, как расширенные символы отображаются.

Чтобы выяснить текущую кодовую страницу вывода данных консоли, используйте функцию GetConsoleOutputCP. Чтобы установить и извлечь кодовую страницу ввода консоли, используйте функции SetConsoleCP и GetConsoleCP.

Смотри также

Обзор консольных приложений, Функции консоли, GetConsoleCP, GetConsoleOutputCP, SetConsoleCP

Размещение и совместимость SetConsoleOutputCP

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz