php-doc-en/reference/ctype/reference.xml
Jakub Vrana d2f3b95694 -128 to -1 inclusive (bug #35873)
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@204473 c90b9560-bf6c-de11-be94-00142212c4b1
2006-01-03 16:35:10 +00:00

96 lines
2.7 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.14 $ -->
<!-- Purpose: basic.vartype -->
<!-- Membership: bundled -->
<reference id="ref.ctype">
<title>Character Type Functions</title>
<titleabbrev>ctype</titleabbrev>
<partintro>
<section id="ctype.intro">
&reftitle.intro;
<para>
The functions provided by this extension check whether a character
or string falls into a certain character class according to the
current locale (see also <function>setlocale</function>).
</para>
<para>
When called with an integer argument these functions
behave exactly like their C counterparts from
<filename>ctype.h</filename>.
It means that if you pass an integer smaller than 256 it will use the
ASCII value of it to see if it fits in the specified range (digits are in
0x30-0x39). If the number is between -128 and -1 inclusive then 256 will
be added and the check will be done on that.
</para>
<para>
When called with a string argument they will check
every character in the string and will only return
&true; if every character in the string matches the
requested criteria. When called with an empty string
the result will always be &true; in PHP &lt; 5.1 and &false; since 5.1.
</para>
<para>
Passing anything else but a string or integer will
return &false; immediately.
</para>
<para>
It should be noted that ctype functions are always preferred over
regular expressions, and even to some equivalent str_* and is_* functions.
This is because of the fact that ctype uses a native C library and thus
processes significantly faster.
</para>
</section>
<section id="ctype.requirements">
&reftitle.required;
<para>
None besides functions from the standard C library which are
always available.
</para>
</section>
&reference.ctype.configure;
<section id="ctype.configuration">
&reftitle.runtime;
&no.config;
</section>
<section id="ctype.resources">
&reftitle.resources;
&no.resource;
</section>
<section id="ctype.constants">
&reftitle.constants;
&no.constants;
</section>
</partintro>
&reference.ctype.functions;
</reference>
<!-- 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:"../../../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
-->