Files
doc-fr/reference/ctype/book.xml

83 lines
2.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.ctype" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="bundled" ?>
<title>Vérification des types de caractères</title>
<titleabbrev>ctype</titleabbrev>
<preface xml:id="intro.ctype">
&reftitle.intro;
<para>
Les fonctions fournies par cette extension vérifient si un caractère
ou une chaîne appartient à une certaine classe de caractères, suivant
la configuration locale courante (voir aussi la fonction
<function>setlocale</function>).
</para>
<para>
Lorsqu'appelées avec un entier comme argument, ces fonctions
se comportent exactement comme leur équivalent C du fichier
<filename>ctype.h</filename>.
Cela signifie que si un nombre entier inférieur à 256 est passé, l'équivalent
ASCII de la valeur sera utilisé afin de vérifier s'il se situe bien dans
l'intervalle (les chiffres sont dans l'intervalle 0x30-0x39). Si le nombre
se situe entre -128 et -1 inclus, alors 256 sera ajouté et la vérification
se fera sur le résultat.
</para>
&note.ctype.parameter.non-string;
<para>
Lorsqu'appelées avec une chaîne comme argument, ces fonctions vérifient
chaque caractère de la chaîne et ne retourneront &true; que si chacun
des caractères correspond aux critères. &ctype.result.empty-string;
</para>
<para>
Si l'on passe autre chose qu'une chaîne ou un entier, &false; est retourné
immédiatement.
</para>
<para>
Il est important de garder à l'esprit que les fonctions ctype sont toujours
préférées pour les expressions régulières ainsi que pour les fonctions
préfixées pas <literal>"str_*"</literal> et <literal>"is_*"</literal>.
En effet, ctype utilisant la bibliothèque native C, le
traitement est extrêmement rapide.
</para>
<note>
<para>
Ces fonctions ne sont absolument pas relatives à la bibliothèque Python
"ctypes". Les noms des fonctions sont relatives à l'en-tête du fichier
C <filename>ctype.h</filename> où les fonctions C équivalentes sont définies.
</para>
<para>
Cette extension est antérieure à "ctypes" Python, aussi, toute confusion
causée par cette dénomination est loin d'être la faute de PHP.
</para>
</note>
</preface>
&reference.ctype.setup;
&reference.ctype.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->