cvs: phpdoc(REF_STRUCT_DEV) /en/reference/ctype reference.xml

bjori Sat Oct 27 16:39:34 2007 UTC Modified files: (Branch: REF_STRUCT_DEV) /phpdoc/en/reference/ctype reference.xml Log: Upgrade markup http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/ctype/reference.xml?r1=1.15.2.1&r2=1.15.2.2&diff_format=u Index: phpdoc/en/reference/ctype/reference.xml diff -u phpdoc/en/reference/ctype/reference.xml:1.15.2.1 phpdoc/en/reference/ctype/reference.xml:1.15.2.2 --- phpdoc/en/reference/ctype/reference.xml:1.15.2.1 Wed Oct 3 11:41:09 2007 +++ phpdoc/en/reference/ctype/reference.xml Sat Oct 27 16:39:34 2007 @@ -1,78 +1,79 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15.2.1 $ --> +<!-- $Revision: 1.15.2.2 $ --> <!-- Purpose: basic.vartype --> <!-- Membership: bundled --> - <reference xml:id="ref.ctype" xmlns="http://docbook.org/ns/docbook"> - <title>Character Type Functions</title> - <titleabbrev>ctype</titleabbrev> +<book xml:id="ref.ctype" xmlns="http://docbook.org/ns/docbook"> + <title>Character Type Functions</title> + <titleabbrev>ctype</titleabbrev> + + <preface xml: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> + </preface> + + <chapter xml:id="ctype.setup"> + <title>Installing/Configuring</title> + + <section xml:id="ctype.requirements"> + &reftitle.required; + <para> + None besides functions from the standard C library which are + always available. + </para> + </section> + + &reference.ctype.configure; + + <section xml:id="ctype.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section xml:id="ctype.resources"> + &reftitle.resources; + &no.resource; + </section> + + </chapter> - <partintro> - <section xml: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 xml:id="ctype.requirements"> - &reftitle.required; - <para> - None besides functions from the standard C library which are - always available. - </para> - </section> - - &reference.ctype.configure; - - <section xml:id="ctype.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="ctype.resources"> - &reftitle.resources; - &no.resource; - </section> - - <section xml:id="ctype.constants"> - &reftitle.constants; - &no.constants; - </section> - - </partintro> + <reference xml:id="ctype.functions" xmlns="http://docbook.org/ns/docbook"> + <title>Character Type Functions</title> -&reference.ctype.functions.entities; + &reference.ctype.functions.entities; </reference> +</book> <!-- Keep this comment at the end of the file Local variables: mode: sgml