Forum und email

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 et -1 inclusivement, 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 une chaîne de caractères vide, le résultat sera toujours TRUE dans PHP < 5.1 et FALSE depuis 5.1.

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 of Contents

  • 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 n'est faite que 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