# Verificação de tipo de caractere

# Introdução

As funções providas por esta extensão verificam se um caractere ou uma string está dentro de uma certa classe de caracteres de acordo com a localidade atual (veja também setlocale()).

Quando chamada com um argumento inteiro, estas funções comportam-se exatamente como ocorre na linguagem C usando ctype.h. Significa que, se for passado um inteiro menor que 256, será usado o valor ASCII dele para conferir se está dentro do intervalo especificado (dígitos estão entre 0x30-0x39). Se o número estiver entre -128 e -1 (inclusive), será adicionado 256 e a verificação estará concluída.

Aviso

A partir do PHP 8.1.0, passar um argumento que não seja string foi descontinuado. No futuro, o argumento será interpretado como uma string em vez de um ponto de código ASCII. Dependendo do comportamento esperado, o argumento deve ser convertido para string ou uma chamada explícita para chr() deve ser feita.

Quando chamada com uma string como argumento ela irá verificar todos os caracteres na string e somente retornará `true` se todos os caracteres da string corresponderem ao o critério solicitado. Quando chamada com uma string vazia, o resultado sempre será `false`.

Se for passado qualquer tipo diferente de string ou inteiro a função retornará `false`.

Note que funções "ctype" são sempre preferenciais em relação às expressões regulares, e em relação às funções equivalentes `"str_*"` e `"is_*"`. O motivo é que "ctype" usa a biblioteca nativa C e assim tem um processamento significativamente mais rápido.

> Nota:

> Estas funções não estão relacionadas às da biblioteca "ctypes" do Python. O nome da extensão vem do arquivo de cabeçalho ctype.h onde suas funções equivalentes em C são definidas.

> Esta extensão também é anterior à biblioteca "ctypes" do Python, então qualquer confusão causada por conta da nomenclatura dificilmente é por conta do PHP.

- Instalação/Configuração
  - Dependências
  - Instalação
- Funções da Ctype
  - ctype_alnum — Verifica se os caracteres são alfanuméricos
  - ctype_alpha — Verifica se os caracteres são alfabéticos
  - ctype_cntrl — Verifica se os caracteres são de controle
  - ctype_digit — Verifica se os caracteres são numéricos
  - ctype_graph — Verifica se os caracteres são imprimíveis exceto espaço
  - ctype_lower — Verifica se os caracteres são minúsculos
  - ctype_print — Verifica se os caracteres são imprimíveis
  - ctype_punct — Verifica se é um caractere imprimível que não é um caractere de espaço ou alfanumério
  - ctype_space — Verifica se os caracteres são espaço em branco
  - ctype_upper — Verifica se os caracteres são maiúsculos
  - ctype_xdigit — Verifica se os caracteres representam um dígito hexadecimal

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open