XVII. Funciones de Tipo de Caracter

IntroducciÃ³n

Las funciones que ofrece esta extensiÃ³n chequean si un caracter o cadena se ubica dentro de una determinada clase de caracteres, de acuerdo a la localidad actual (vea tambiÃ©n setlocale()).

Cuando son llamadas con un argumento entero, estas funciones se comportan exactamente como sus homÃ³logos de C provenientes de ctype.h. Esto quiere decir que si pasa un entero menor que 256, usarÃ¡ su valor ASCII para verificar si se ajusta al rango especificado (los dÃgitos estÃ¡n entre 0x30-0x39). Si el nÃºmero se encuentra entre -128 y -1 inclusive entonces se le sumarÃ¡ 256 y el chequeo se realizarÃ¡ sobre ese valor.

Cuando son llamadas con un argumento de tipo cadena, chequearÃ¡n cada caracter de la cadena y solo devolverÃ¡n TRUE si cada caracter de la cadena coincide con el criterio solicitado. Cuando son llamadas con una cadena vacÃa, el resultado serÃ¡ siempre TRUE en PHP < 5.1 y FALSE a partir de 5.1.

Al pasar cualquier cosa diferente a una cadena o un entero, se devolverÃ¡ FALSE inmediatamente.

Debe notarse que se prefieren siempre las funciones ctype sobre las expresiones regulares, e incluso sobre algunas funciones str_* e is_* equivalentes. Esto se debe a que ctype usa una biblioteca C nativa y por lo tanto realiza sus procesos significativamente mÃ¡s rÃ¡pido.

Requisitos

Ninguno aparte de las funciones de la biblioteca de C estÃ¡ndar, la cual se encuentra disponible siempre.

InstalaciÃ³n

A partir de PHP 4.2.0 estas funciones estÃ¡n habilitadas por defecto. En versiones anteriores es necesario configurar y compilar PHP con el parÃ¡metro --enable-ctype. Es posible deshabilitar el soporte para ctype con --disable-ctype.

La versiÃ³n para Windows de PHP tiene soporte nativo para esta extensiÃ³n. No se necesita cargar ninguna extensiÃ³n adicional para usar estas funciones.

Nota: A partir de PHP 4.3.0 el soporte para ctype es nativo.

ConfiguraciÃ³n en tiempo de ejecuciÃ³n

Esta extensiÃ³n no tiene directivas de configuraciÃ³n en php.ini.

Tipos de recursos

Esta extensiÃ³n no tiene ningÃºn tipo de recurso definido.

Constantes predefinidas

Esta extensiÃ³n no tiene ninguna constante definida.

Tabla de contenidos
ctype_cntrl -- Chequear posibles caracteres de control
ctype_graph -- Chequear posibles caracteres imprimibles, con excepciÃ³n de los espacios
ctype_lower -- Chequear posibles caracteres en minÃºscula
ctype_print -- Chequear posibles caracteres imprimibles
ctype_punct -- Chequear posibles caracteres imprimibles que no son ni espacios en blanco ni caracteres alfanumÃ©ricos
ctype_space -- Chequear posibles caracteres de espacio en blanco
ctype_upper -- Chequear posibles caracteres en mayÃºscula
ctype_xdigit -- Chequear posibles caracteres que representen un dÃgito hexadecimal

add a note User Contributed Notes
Funciones de Tipo de Caracter

avarab at gmail dot com
03-Jan-2006 12:58


In case the ctype_*() functions aren't compiled in your PHP and you can't recompile for some reason (e.g. shared host) you can use the compatability functions from the MediaWiki project which use preg_* as a replacement[1], removing lines 2 and 3 in the source should make them suitable for usage elsewhere.



Shameless self-advertisement, but hey, we find them useful;)



1. A tinyurl because the submission script complained about long lines: http://tinyurl.com/7hz4l

1. The real url split up:

http://cvs.sourceforge.net/viewcvs.py/*checkout*/

wikipedia/phase3/includes/compatability/ctype.php

Gregory Boshoff
07-Aug-2005 08:47


As noted above unfortunately many PHP developers are seemingly unaware of these functions and are still using less  efficient equivalents. 



Use the ctype functions for input type vaildation.



Example wrapper function:



 function detect_type($str, $type_req = ''){

        $type = array();

      (ctype_alnum($str) === TRUE) ? ($type = 'alnum') : FALSE;

      (ctype_digit($str) === TRUE) ? ($type = 'digit') : FALSE;

      (ctype_alpha($str) === TRUE) ? ($type = 'alpha') : FALSE;

        return ($type === $type_req) ? TRUE : FALSE;

    } // end fun



$str = 'AlphaString';

$type_req = 'alpha';



// Returns TRUE if the string is of the required type

echo detect_type($str, $type_req);