curses.ascii — Utilities for ASCII characters

---

Модуль curses.ascii надає константи імен для символів ASCII і функції для перевірки належності до різних класів символів ASCII. Надані константи є такими іменами керуючих символів:

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

Зверніть увагу, що багато з них не мають практичного значення в сучасному використанні. Мнемоніка походить від телепринтерів, які передували цифровим комп’ютерам.

Модуль надає такі функції, створені за зразком стандартної бібліотеки C:

curses.ascii.isalnum(c)

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

curses.ascii.isalpha(c)

Перевіряє наявність літер ASCII; це еквівалентно isupper(c) або 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 в 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 в 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 для символу пробілу.