# `curses.ascii` — Utilities for ASCII characters

Código-fonte: Lib/curses/ascii.py

O módulo `curses.ascii` fornece constantes de nome para caracteres ASCII e funções para testar associação em várias classes de caracteres ASCII. As constantes fornecidas são nomes para caracteres de controle, como detalhado a seguir:

Nome | Significado
--- | ---
`NUL` |
`SOH` | Início do cabeçalho, interrupção do console
`STX` | Início de texto
`ETX` | Fim de texto
`EOT` | Fim de transmissão
`ENQ` | Consulta, segue com controle de fluxo `ACK`
`ACK` | Confirmação
`BEL` | Campainha
`BS` | Backspace
`TAB` | Tabulação
`HT` | Apelido para `TAB`: “Tabulação horizontal”
`LF` | Alimentação de linha ou line feed
`NL` | Apelido para `LF`: “Nova linha”
`VT` | Tabulação vertical
`FF` | Alimentação de formulário ou form feed
`CR` | Retorno de carro ou carriage return
`SO` | Deslocamento para fora ou shift-out, inicia um conjunto de caracteres alternativo
`SI` | Deslocamento para dentro ou shift-in, retoma o conjunto de caracteres padrão
`DLE` | Escape de conexão ou data-link escape
`DC1` | XON, para controle de fluxo
`DC2` | Controle de dispositivo 2, control de fluxo em modo bloco
`DC3` | XOFF, para controle de fluxo
`DC4` | Controle de dispositivo 4
`NAK` | Confirmação negativa
`SYN` | Estado ocioso síncrono
`ETB` | Bloco de fim de transmissão
`CAN` | Cancelar
`EM` | Fim de mídia
`SUB` | Substituir
`ESC` | Escapar
`FS` | Separador de arquivos
`GS` | Separador de grupos
`RS` | Separador de registros, terminador de modo bloco
`US` | Separador de unidades
`SP` | Espaço
`DEL` | Excluir

Note que muitos deles têm pouca significância prática no uso moderno. Os mnemônicos derivam de convenções de teleimpressoras que antecedem os computadores digitais.

O módulo fornece as seguintes funções, baseadas nas da biblioteca C padrão:

`curses.ascii.``isalnum`(c)

  Verifica se há um caractere alfanumérico ASCII; equivale a `isalpha(c) or isdigit(c)`.

`curses.ascii.``isalpha`(c)

  Verifica se há um caractere alfabético ASCII; equivale a `isupper(c) or islower(c)`.

`curses.ascii.``isascii`(c)

  Verifica se há um valor de caractere que se encaixa no conjunto ASCII de 7 bits.

`curses.ascii.``isblank`(c)

  Verifica se há um caractere de espaço em branco ASCII; espaço ou tabulação horizontal.

`curses.ascii.``iscntrl`(c)

  Verifica se há um caractere de controle ASCII (no intervalo de 0x00 a 0x1f ou 0x7f).

`curses.ascii.``isdigit`(c)

  Verifica se há um dígito decimal ASCII, `'0'` a `'9'`. Isso equivale a `c in string.digits`.

`curses.ascii.``isgraph`(c)

  Verifica se há algum caractere ASCII imprimível, exceto espaço.

`curses.ascii.``islower`(c)

  Verifica se há um caractere ASCII minúsculo.

`curses.ascii.``isprint`(c)

  Verifica se há algum caractere ASCII imprimível, incluindo espaço.

`curses.ascii.``ispunct`(c)

  Verifica se há algum caractere ASCII imprimível que não seja um espaço ou um caractere alfanumérico.

`curses.ascii.``isspace`(c)

  Verifica caracteres de espaço em branco ASCII; espaço, quebra de linha, retorno de carro, quebra de página, tabulação horizontal, tabulação vertical.

`curses.ascii.``isupper`(c)

  Verifica se há uma letra maiúscula ASCII.

`curses.ascii.``isxdigit`(c)

  Verifica se há um dígito hexadecimal ASCII. Isso equivale a `c in string.hexdigits`.

`curses.ascii.``isctrl`(c)

  Verifica se há um caractere de controle ASCII (valores ordinais de 0 a 31).

`curses.ascii.``ismeta`(c)

  Verifica se há um caractere não ASCII (valores ordinais 0x80 e acima).

Essas funções aceitam números inteiros ou strings de caracteres únicos; quando o argumento é uma string, ele é primeiro convertido usando a função embutida `ord()`.

Observe que todas essas funções verificam valores de bits ordinais derivados do caractere da string que você passa; elas não sabem nada sobre a codificação de caracteres da máquina host.

As duas funções a seguir aceitam uma string de caractere único ou um valor de byte inteiro; elas retornam um valor do mesmo tipo.

`curses.ascii.``ascii`(c)

  Retorna o valor ASCII correspondente aos 7 bits mais baixos de c.

`curses.ascii.``ctrl`(c)

  Retorna o caractere de controle correspondente ao caractere fornecido (é feito um E bit a bit com 0x1f sobre o valor do bit do caractere).

`curses.ascii.``alt`(c)

  Retorna o caractere de 8 vits correspondente ao caractere ASCII fornecido (é feito um OU bit a bit com 0x80 sobre o valor do bit do caractere).

A função a seguir aceita uma string de um único caractere ou um valor inteiro; ela retorna uma string.

`curses.ascii.``unctrl`(c)

  Retorna uma representação de string do caractere ASCII c. Se c for imprimível, essa string é o próprio caractere. Se o caractere for um caractere de controle (0x00–0x1f), a string consiste em um acento circunflexo (`'^'`) seguido pela letra maiúscula correspondente. Se o caractere for de exclusão ASCII (0x7f), a string é `'^?'`. Se o caractere tiver seu metabit (0x80) definido, o metabit é removido, as regras precedentes são aplicadas e `'!'` é adicionado ao resultado.

`curses.ascii.``controlnames`

  Um vetor de strings de 33 elementos que contém os mnemônicos ASCII para os trinta e dois caracteres de controle ASCII de 0 (NUL) a 0x1f (US), em ordem, mais o mnemônico `SP` para o caractere de espaço.