curses.ascii — Утилиты для ASCII символов


Модуль curses.ascii предоставляет константы имён для ASCII символов и функций для проверки принадлежности к различным классам ASCII символов. Поставляемые константы являются именами управляющих символов, как показано ниже:

Имя Значение
NUL  
SOH Начало заголовка, консольное прерывание
STX Начало текста
ETX Конец текста
EOT Конец передачи
ENQ Запрос, идёт с ACK управлением потока
ACK Подтверждение
BEL Звонок
BS Backspace
TAB Tab
HT Псевдоним для TAB: «Горизонтальный tab»
LF Перевод строки
NL Псевдоним для LF: «Новая строка»
VT Вертикальный tab
FF Перевод страницы
CR Возврат каретки
SO Shift-out, начать альтернативный набор символов
SI Shift-in, возобновить набор символов по умолчанию
DLE Escape канала передачи данных
DC1 XON, для контроля потока
DC2 Устройство управления 2, блочный-режим управления потоком
DC3 XOFF, для контроля потока
DC4 Устройство управления 4
NAK Отрицательное подтверждение
SYN Синхронный холостой ход
ETB Конец блока передачи
CAN Отменить
EM Завершение средних
SUB Замена
ESC Escape
FS Разделитель файлов
GS Разделитель групп
RS Разделитель записей, завершитель блочного режима
US Блок сепаратора
SP Пробел
DEL Удалить

Обратите внимание, что многие из них не имеют большого практического значения в современном использовании. Мнемоника происходит от соглашений о телетайпах, предшествовавших цифровым компьютерам.

Модуль предоставляет следующие функции, аналогичные функциям стандартной библиотеки C:

curses.ascii.isalnum(c)

Проверяет наличие буквенно-цифрового ASCII символа; он эквивалентен isalpha(c) or isdigit(c).

curses.ascii.isalpha(c)

Проверяет наличие буквенного ASCII символа; он эквивалентен isupper(c) or islower(c).

curses.ascii.isascii(c)

Проверяет значение символа, которое соответствует 7-битному набору ASCII.

curses.ascii.isblank(c)

Проверяет наличие символа пробела ASCII; пробел или горизонтальная табуляция.

curses.ascii.iscntrl(c)

Проверяет наличие управляющего ASCII символа (в диапазоне от 0x00 до 0x1f или 0x7f).

curses.ascii.isdigit(c)

Проверяет наличие десятичной цифры ASCII, от '0' до '9'. Это эквивалент c in string.digits.

curses.ascii.isgraph(c)

Проверяет наличие в ASCII любого печатаемого символа, кроме пробела.

curses.ascii.islower(c)

Проверяет наличие символа нижнего регистра ASCII.

curses.ascii.isprint(c)

Проверяет наличие любого печатаемого ASCII символа, включая пробел.

curses.ascii.ispunct(c)

Проверяет наличие любого печатаемого ASCII символа, не являющегося пробелом или буквенно-цифровым символом.

curses.ascii.isspace(c)

Проверяет наличие символов пробела ASCII; пробел, перевод строки, возврат каретки, подача страницы, горизонтальная табуляция, вертикальная табуляция.

curses.ascii.isupper(c)

Проверяет наличие буквы ASCII в верхнем регистре.

curses.ascii.isxdigit(c)

Проверяет наличие шестнадцатеричной цифры ASCII. Это эквивалентно c in string.hexdigits.

curses.ascii.isctrl(c)

Проверяет наличие управляющего ASCII символа (порядковые значения от 0 до 31).

curses.ascii.ismeta(c)

Проверяет наличие символа, отличного от ASCII (порядковые значения 0x80 и выше).

Эти функции принимают либо целые числа, либо односимвольные строки; когда аргумент является строкой, она сначала преобразуется с помощью встроенной функции ord().

Обратите внимание, что все эти функции проверяют порядковые битовые значения, полученные из символа передаваемой вами строки; они фактически ничего не знают о кодировке символов хост-машины.

Следующие две функции принимают либо односимвольную строку, либо целочисленное байтовое значение; они возвращают значение того же типа.

curses.ascii.ascii(c)

Возвращает значение ASCII, соответствующее младшим 7 битам c.

curses.ascii.ctrl(c)

Возвращение управляющего символа, соответствующего данному символу (битовое значение символа имеет побитовое значение 0x1f).

curses.ascii.alt(c)

Возвращает 8-битный символ, соответствующий данному символу ASCII (битовое значение символа имеет побитовое значение 0x80).

Следующая функция принимает либо односимвольную строку, либо целочисленное значение; он возвращает строку.

curses.ascii.unctrl(c)

Возвращает строковое представление ASCII символа c. Если c можно распечатать, строка является самим символом. Если символ является управляющим символом (0x00–0x1f), строка состоит из символа вставки ('^'), за которым следует соответствующая заглавная буква. Если это символ удаления ASCII (0x7f), строка будет '^?'. Если у символа установлен мета-бит (0x80), мета-бит удаляется, применяются предыдущие правила и к результату добавляется '!'.

curses.ascii.controlnames

Строковый массив из 33 элементов, который содержит мнемонику ASCII для тридцати двух управляющих ASCII символов от 0 (NUL) до 0x1f (США) по порядку, а также мнемонику SP для символа пробела.