curses.ascii — Hilfsprogramme für ASCII-Zeichen

Quellcode: Lib/curses/ascii.py

Das Modul curses.ascii stellt Namenskonstanten für ASCII-Zeichen und Funktionen zum Testen der Mitgliedschaft in verschiedenen ASCII-Zeichenklassen bereit. Die bereitgestellten Konstanten sind Namen für Steuerzeichen wie folgt:

Name

Bedeutung
curses.ascii.NUL
curses.ascii.SOH

Start of heading, console interrupt
curses.ascii.STX

Start of text
curses.ascii.ETX

End of text
curses.ascii.EOT

End of transmission
curses.ascii.ENQ

Enquiry, goes with ACK flow control
curses.ascii.ACK

Acknowledgement
curses.ascii.BEL

Bell
curses.ascii.BS

Backspace
curses.ascii.TAB

Tab
curses.ascii.HT

Alias for TAB: “Horizontal tab”
curses.ascii.LF

Line feed
curses.ascii.NL

Alias for LF: “New line”
curses.ascii.VT

Vertical tab
curses.ascii.FF

Form feed
curses.ascii.CR

Carriage return
curses.ascii.SO

Shift-out, begin alternate character set
curses.ascii.SI

Shift-in, resume default character set
curses.ascii.DLE

Data-link escape
curses.ascii.DC1

XON, for flow control
curses.ascii.DC2

Device control 2, block-mode flow control
curses.ascii.DC3

XOFF, for flow control
curses.ascii.DC4

Device control 4
curses.ascii.NAK

Negative acknowledgement
curses.ascii.SYN

Synchronous idle
curses.ascii.ETB

End transmission block
curses.ascii.CAN

Cancel
curses.ascii.EM

End of medium
curses.ascii.SUB

Substitute
curses.ascii.ESC

Escape
curses.ascii.FS

File separator
curses.ascii.GS

Group separator
curses.ascii.RS

Record separator, block-mode terminator
curses.ascii.US

Unit separator
curses.ascii.SP

Space
curses.ascii.DEL

Delete

Beachten Sie, dass viele davon in der modernen Nutzung wenig praktische Bedeutung haben. Die Mnemonika leiten sich von Fernschreibkonventionen ab, die älter als digitale Computer sind.

Das Modul stellt die folgenden Funktionen zur Verfügung, die den Funktionen der Standard-C-Bibliothek nachempfunden sind:

curses.ascii.isalnum(c)

Prüft auf ein ASCII-alphanumerisches Zeichen; dies ist äquivalent zu isalpha(c) oder isdigit(c).

curses.ascii.isalpha(c)

Prüft auf ein ASCII-alphabisches Zeichen; dies ist äquivalent zu isupper(c) oder islower(c).

curses.ascii.isascii(c)

Prüft, ob ein Zeichenwert in das 7-Bit-ASCII-Set passt.

curses.ascii.isblank(c)

Prüft auf ein ASCII-Leerzeichen; Leerzeichen oder horizontales Tabulatorzeichen.

curses.ascii.iscntrl(c)

Prüft auf ein ASCII-Steuerzeichen (im Bereich 0x00 bis 0x1f oder 0x7f).

curses.ascii.isdigit(c)

Prüft auf eine ASCII-Dezimalziffer, '0' bis '9'. Dies ist äquivalent zu c in string.digits.

curses.ascii.isgraph(c)

Prüft auf ein beliebiges druckbares ASCII-Zeichen außer Leerzeichen.

curses.ascii.islower(c)

Prüft auf ein ASCII-Kleinbuchstaben.

curses.ascii.isprint(c)

Prüft auf ein beliebiges druckbares ASCII-Zeichen, einschließlich Leerzeichen.

curses.ascii.ispunct(c)

Prüft auf ein druckbares ASCII-Zeichen, das kein Leerzeichen oder alphanumerisches Zeichen ist.

curses.ascii.isspace(c)

Prüft auf ASCII-Leerzeichen: Leerzeichen, Zeilenvorschub, Wagenrücklauf, Seitenvorschub, horizontaler Tabulator, vertikaler Tabulator.

curses.ascii.isupper(c)

Prüft auf einen ASCII-Großbuchstaben.

curses.ascii.isxdigit(c)

Prüft auf eine ASCII-Hexadezimalziffer. Dies ist äquivalent zu c in string.hexdigits.

curses.ascii.isctrl(c)

Prüft auf ein ASCII-Steuerzeichen (Ordinalwerte 0 bis 31).

curses.ascii.ismeta(c)

Prüft auf ein Nicht-ASCII-Zeichen (Ordinalwerte 0x80 und höher).

Diese Funktionen akzeptieren entweder ganze Zahlen oder Zeichenketten mit einem Zeichen; wenn das Argument eine Zeichenkette ist, wird es zunächst mit der integrierten Funktion ord() konvertiert.

Beachten Sie, dass all diese Funktionen bitweise Werte überprüfen, die vom Zeichen der übergebenen Zeichenkette abgeleitet sind; sie wissen nichts über die Zeichenkodierung des Host-Systems.

Die folgenden beiden Funktionen nehmen entweder eine Zeichenkette mit einem Zeichen oder einen Ganzzahl-Byte-Wert entgegen; sie geben einen Wert vom gleichen Typ zurück.

curses.ascii.ascii(c)

Gibt den ASCII-Wert zurück, der den niedrigen 7 Bits von c entspricht.

curses.ascii.ctrl(c)

Gibt das Steuerzeichen zurück, das dem gegebenen Zeichen entspricht (der Zeichen-Bitwert wird bitweise mit 0x1f verknüpft).

curses.ascii.alt(c)

Gibt das 8-Bit-Zeichen zurück, das dem gegebenen ASCII-Zeichen entspricht (der Zeichen-Bitwert wird bitweise mit 0x80 verknüpft).

Die folgende Funktion nimmt entweder eine Zeichenkette mit einem Zeichen oder einen Ganzzahlwert entgegen; sie gibt eine Zeichenkette zurück.

curses.ascii.unctrl(c)

Gibt eine Zeichenkettendarstellung des ASCII-Zeichens c zurück. Wenn c druckbar ist, ist diese Zeichenkette das Zeichen selbst. Wenn das Zeichen ein Steuerzeichen (0x00–0x1f) ist, besteht die Zeichenkette aus einem Caret ('^'), gefolgt vom entsprechenden Großbuchstaben. Wenn das Zeichen ein ASCII-Delete (0x7f) ist, ist die Zeichenkette '^?'. Wenn das Zeichen sein Meta-Bit (0x80) gesetzt hat, wird das Meta-Bit entfernt, die vorherigen Regeln angewendet und '!' dem Ergebnis vorangestellt.

curses.ascii.controlnames

Ein String-Array mit 33 Elementen, das die ASCII-Mnemonika für die zweiunddreißig ASCII-Steuerzeichen von 0 (NUL) bis 0x1f (US) in Reihenfolge enthält, plus die Mnemonika SP für das Leerzeichen.