array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.ctype-alpha.php', 1 => 'ctype_alpha', 2 => 'Chequear posibles caracteres alfabéticos', ), 'up' => array ( 0 => 'ref.ctype.php', 1 => 'Funciones de Ctype', ), 'prev' => array ( 0 => 'function.ctype-alnum.php', 1 => 'ctype_alnum', ), 'next' => array ( 0 => 'function.ctype-cntrl.php', 1 => 'ctype_cntrl', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/ctype/functions/ctype-alpha.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ctype_alpha

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

ctype_alpha — Chequear posibles caracteres alfabéticos

Descripción

ctype_alpha(mixed $text): bool

Verifica si todos los caracteres en la string entregada,texto, son alfabéticos. En la localización C estándar las letras se limitan a [A-Za-z] y ctype_alpha() es equivalente a (ctype_upper($texto) || ctype_lower($texto)) si $texto es un caracter sencillo, aunque otros idiomas usan letras que no son consideradas como mayúsculas ni minúsculas.

Parámetros

text

El string de prueba.

Nota:

Si se proporciona un entero en el rango -128 y 255 inclusive, será interpretado como el valor ASCII de un solo carácter (los valores negativos se verán añadir 256 para permitir caracteres en el rango ASCII extendido). Cualquier otro entero será interpretado como una cadena de caracteres que contiene los dígitos decimales del entero.

Advertencia

Desde PHP 8.1.0, pasar un argumento diferente de una cadena está obsoleto. En el futuro, el argumento será interpretado como una cadena de caracteres en lugar de un punto de código ASCII. Según el comportamiento deseado, el argumento debe ser convertido a string o debe realizarse una llamada explícita a chr().

Valores devueltos

Devuelve true si cada caracter de texto es una letra de la localización actual, false de lo contrario. Cuando se llama con una cadena vacía, el resultado será siempre false.

Ejemplos

Ejemplo #1 Un ejemplo de ctype_alpha() (usando la localización predeterminada)

<?php
$cadenas = array('KjgWZC', 'arf12');
foreach ($cadenas as $caso_prueba) {
if (ctype_alpha($caso_prueba)) {
echo "La cadena $caso_prueba consiste completamente de letras.\n";
} else {
echo "La cadena $caso_prueba no consiste completamente de letras.\n";
}
}
?>

El ejemplo anterior mostrará:

La cadena KjgWZC consiste completamente de letras.
La cadena arf12 no consiste completamente de letras.

Ver también