XV. Caractères

Introduction

Ces fonctions vérifient si un caractère ou une chaîne de caractères font partie d'une certaine classe de caractères, en fonction de la configuration locale (voir aussi setlocale()).

Appelées avec un argument de type entier, ces fonctions se comportent exactement comme leur équivalent en langage C, du fichier ctype.h. Cela signifie que si vous passez un entier plus petit que 256, la fonction utilisera la valeur ASCII de cet entier pour voir s'il se trouve dans l'intervalle spécifique (les digitaux sont dans l'intervalle 0x30-0x39). Si le nombre est entre -128 (inclusif) et 0, alors 256 sera ajouté et la vérification sera effectué sur le nombre résultant.

Appelées avec un argument de type chaîne, elles vérifieront chaque caractère de la chaîne, et ne retourneront TRUE que si chacun satisfait les critères requis. Appelées avec un argument vide, le résultat sera toujours TRUE.

Tout autre type d'argument (autre que chaîne ou entier) génère une erreur, et retourne FALSE immédiatement.

Il est à noter que les fonctions ctype sont toujours préférables par rapport aux expressions rationnelles ainsi que les fonctions équivalentes str_* et is_*. Les fonctions ctype utilisent une bibliothèque C native qui les rendent bien plus rapides.

Pré-requis

Aucun pré-requis pour utiliser cette extension, hormis la bibliothèque C standard, qui est toujours disponible.

Installation

Depuis PHP 4.2.0, ces fonctions sont activées par défaut. Pour les versions plus anciennes, vous devrez configurer et compiler PHP avec l'option --enable-ctype. Vous pouvez toujours désactiver le support de l'extension ctype avec l'option de compilation --disable-ctype.

La version Windows de PHP dispose du support automatique de cette extension. Vous n'avez pas à ajouter de bibliothèque supplémentaire pour disposer de ces fonctions.

Note : Cette bibliothèque fait partie intégrante de PHP depuis la version 4.3.0.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

Cette extension ne définit aucune constante.

Table des matières
ctype_alnum --  Vérifie qu'une chaîne est alpha-numérique
ctype_alpha --  Vérifie qu'une chaîne est alphabétique
ctype_cntrl --  Vérifie qu'un caractère est un caractère de contrôle
ctype_digit -- Vérifie qu'une chaîne est un entier
ctype_graph --  Vérifie qu'une chaîne est imprimable
ctype_lower -- Vérifie qu'une chaîne est en minuscules
ctype_print -- Vérifie qu'une chaîne est imprimable
ctype_punct --  Vérifie qu'une chaîne contient de la ponctuation
ctype_space --  Vérifie qu'une chaîne est faîte de caractères blancs
ctype_upper -- Vérifie qu'une chaîne est en majuscules
ctype_xdigit --  Vérifie qu'un caractère représente un nombre hexadécimal