array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'book.ctype.php', 1 => 'Ctype', 2 => 'Verificação de tipo de caractere', ), 'up' => array ( 0 => 'refs.basic.vartype.php', 1 => 'Extensões Relacionadas a Variáveis e Tipos', ), 'prev' => array ( 0 => 'function.trait-exists.php', 1 => 'trait_exists', ), 'next' => array ( 0 => 'ctype.setup.php', 1 => 'Instalação/Configuração', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ctype/book.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/book.ctype.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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.