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 whitespace; пробел или горизонтальная табуляция.

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 whitespace; пробел, перевод строки, возврат каретки, перевод страницы, горизонтальная табуляция, вертикальная табуляция.

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