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

ctype_alnum

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

ctype_alnum — Chequear posibles caracteres alfanuméricos

Descripción

function ctype_alnum(mixed $text): bool

Chequea si todos los caracteres en la string entregada, texto, son alfanuméricos.

Parámetros

text

La cadena de prueba.

Nota: Si se proporciona un int entre -128 y 255 inclusive, este se interpreta como el valor ASCII de un solo carácter (a los valores negativos se les añade 256 para permitir caracteres del rango ASCII extendido). Cualquier otro entero se interpreta como un string que contiene los dígitos decimales del entero.

Advertencia

A partir de PHP 8.1.0, pasar un argumento que no sea string está obsoleto. En el futuro, el argumento se interpretará como un string en lugar de un punto de código ASCII. Según el comportamiento deseado, el argumento debería convertirse a string o se debería realizar una llamada explícita a chr().

Valores devueltos

Devuelve true si cada caracter de texto es o bien uno letra o un dígito, false de lo contrario. Cuando se llama con una cadena vacía, el resultado será siempre false.

Ejemplos

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

<?php
$cadenas = array('AbCd1zyZ9', 'foo!#$bar');
foreach ($cadenas as $caso_prueba) {
    if (ctype_alnum($caso_prueba)) {
        echo "La cadena $caso_prueba consiste completamente de letras o dígitos.\n";
    } else {
        echo "La cadena $caso_prueba no consiste completamente de letras o dígitos.\n";
    }
}
?>

El ejemplo anterior mostrará:

La cadena AbCd1zyZ9 consiste completamente de letras o dígitos.
La cadena foo!#$bar no consiste completamente de letras o dígitos.

Véase también