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 для пробела.