curses.ascii — Инструменты для ASCII-символов

Модуль 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().

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

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

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