6.17 curses.ascii -- Utilità per i caratteri ASCII

Nuovo nella versione 1.6.

Il modulo curses.ascii fornisce dei nomi costanti per i caratteri ASCII, e delle funzioni per testarne l'appartenenza a varie classi di caratteri ASCII. Le costanti fornite sono nomi di caratteri di controllo come segue:

Nome  Significato 
NUL  
SOH Inizio dell'intestazione, segnale di interrupt della console
STX Inizio del testo
ETX Fine del testo
EOT Fine della trasmissione
ENQ Interrogazione, esegue un controllo di flusso con ACK
ACK Dichiarazione
BEL Campanella
BS Backspace
TAB Tab
HT Sinonimo per TAB: ``Tab orizzontale''
LF Avanzamento di riga
NL Sinonimo per LF: ``Nuova riga''
VT Tab verticale
FF Avanzamento di pagina
CR Ritorno del carrello (NdT: ritorno a capo)
SO Shift-out, inizia ad alternare l'insieme dei caratteri
SI Shift-in, ripristina l'insieme dei caratteri predefiniti
DLE Escape Data-link
DC1 XON, per il controllo del flusso
DC2 Dispositivo di controllo 2, modo bloccante per il controllo di flusso
DC3 XOFF, per il controllo di flusso
DC4 Dispositivo di controllo 4
NAK Negazione
SYN Sincronia dell'idle
ETB Fine del blocco di trasmissione
CAN Cancella
EM Fine del mezzo di trasmissione
SUB Sostituisci
ESC Esci
FS Separatore di file
GS Separatore di gruppo
RS Separatore di record, termina la modalità bloccante
US Unisci i separatori
SP Spazio
DEL Cancella

Notate che nell'uso moderno molti di questi termini possiedono un significato pratico ridotto. I significati mnemonici derivano dalle convenzioni delle telescriventi che hanno preceduto i calcolatori digitali.

Il modulo fornisce le seguenti funzioni, sulla base di quelle presenti nella libreria standard C.

isalnum( c)
Verifica che c sia un carattere ASCII alfanumerico; è equivalente a "isalpha(c) o isdigit(c)".

isalpha( c)
Verifica che c sia un carattere ASCII alfabetico; è equivalente a "isupper(c) o islower(c)".

isascii( c)
Verifica che il valore di un carattere c sia contenuto nell'insieme a 7-bit ASCII.

isblank( c)
Verifica che c sia uno spazio ASCII.

iscntrl( c)
Verifica che c sia un carattere di controllo ASCII (nell'intervallo 0x00 - 0x1f).

isdigit( c)
Verifica che c sia una cifra decimale ASCII, da "0" a "9". È equivalente a "c in string.digits".

isgraph( c)
Verifica che c sia un carattere ASCII stampabile, ad eccezione dello spazio.

islower( c)
Verifica che c sia un carattere ASCII minuscolo.

isprint( c)
Verifica che c sia un carattere ASCII stampabile, incluso lo spazio.

ispunct( c)
Verifica che c sia un carattere ASCII stampabile, diverso dallo spazio o da un carattere alfanumerico.

isspace( c)
Verifica che c sia uno spazio vuoto ASCII; cioè uno tra: spazio, line-feed, ritorno del carrello, avanzamento di pagina, tab orizzontale, tab verticale.

isupper( c)
Verifica che c sia una lettera ASCII maiuscola.

isxdigit( c)
Verifica che c sia una cifra ASCII esadecimale. È equivalente a "c in string.hexdigits".

isctrl( c)
Verifica che c sia un carattere di controllo ASCII (valori ordinali da 0 a 31).

ismeta( c)
Verifica che c non sia un carattere ASCII (valori ordinali oltre 0x80).

Queste funzioni accettano sia interi che stringhe; quando l'argomento è una stringa, viene prima convertito usando la funzione ord().

Notate che tutte queste funzioni verificano i valori bit ordinali derivati dal primo carattere della stringa che viene passata; non sanno nulla riguardo la codifica dei caratteri della macchina ospite. Per le funzioni che riconoscono la codifica dei caratteri (e gestiscono in modo appropriato l'internazionalizzazione) vedete il modulo string.

Le seguenti due funzioni accettano sia una stringa di un unico carattere, che un valore di bit intero; restituiscono un valore dello stesso tipo.

ascii( c)
Restituisce il valore ASCII corrispondente ai primi 7 bit di c.

ctrl( c)
Restituisce il carattere di controllo corrispondente al carattere dato (sul valore di bit del carattere viene eseguito un and bit per bit con 0x1f).

alt( c)
Restituisce il carattere a 8 bit corrispondente al carattere ASCII dato (sul valore di bit del carattere viene eseguito un or bit per bit con 0x80).

La seguente funzione accetta sia una stringa di un unico carattere, che un valore intero; restituisce una stringa.

unctrl( c)
Restituisce una rappresentazione sotto forma di stringa del carattere ASCII di c. Se c è stampabile, la stringa sarà il carattere stesso. Se è un carattere di controllo (0x00-0x1f), la stringa sarà composta da un carattere di omissione ("^") seguito dalla corrispondente lettere maiuscola. Se il carattere è un ASCII delete (0x7f), la stringa sarà '^?'. Se il carattere ha il suo meta bit (0x80) impostato, quest'ultimo verrà rimosso, le precedenti regole verranno applicate, e infine verrà anteposto il carattere "!" al risultato.

controlnames
Un array stringa di 33 elementi che contiene i mnemonic ASCII per i 32 caratteri di controllo ASCII da 0 (NUL) a 0x1f (US), in ordine, più il mnemonico "SP" per il carattere spazio.
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.