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

Исходный код: Lib/curses/ascii.py

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

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

Модуль предоставляет следующие функции, по образцу тех, что есть в стандартной библиотеке 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 (US) в порядке следования, плюс мнемоника SP для пробела.