cvs: phpdoc-fr /reference/intl/collator asort.xml compare.xml construct.xml create.xml get-attribute.xml get-error-code.xml get-error-message.xml
get-locale.xml get-strength.xml set-attribute.xml set-strength.xml sort-with-sort-keys.xml sort.xml /reference/intl/functions grapheme-extract.xml
grapheme-stripos.xml grapheme-stristr.xml grapheme-strlen.xml grapheme-strpos.xml grapheme-strripos.xml grapheme-strrpos.xml grapheme-strstr.xml
grapheme-substr.xml intl-error-name.xml intl-get-error-code.xml intl-get-error-message.xml intl-is-failure.xml
| From: | Damien Seguy | Date: | Thu, 29 Jan 2009 21:34:32 +0000 |
| Subject: | cvs: phpdoc-fr /reference/intl/collator asort.xml compare.xml construct.xml create.xml get-attribute.xml get-error-code.xml get-error-message.xml get-locale.xml get-strength.xml set-attribute.xml set-strength.xml sort-with-sort-keys.xml sort.xml /reference/intl/functions grapheme-extract.xml grapheme-stripos.xml grapheme-stristr.xml grapheme-strlen.xml grapheme-strpos.xml grapheme-strripos.xml grapheme-strrpos.xml grapheme-strstr.xml grapheme-substr.xml intl-error-name.xml intl-get-error-code.xml intl-get-error-message.xml intl-is-failure.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6535@lists.php.net to get a copy of this message | ||
dams Thu Jan 29 21:34:32 2009 UTC
Added files:
/phpdoc-fr/reference/intl/collator asort.xml compare.xml
construct.xml create.xml
get-attribute.xml
get-error-code.xml
get-error-message.xml
get-locale.xml get-strength.xml
set-attribute.xml
set-strength.xml
sort-with-sort-keys.xml sort.xml
/phpdoc-fr/reference/intl/functions grapheme-extract.xml
grapheme-stripos.xml
grapheme-stristr.xml
grapheme-strlen.xml
grapheme-strpos.xml
grapheme-strripos.xml
grapheme-strrpos.xml
grapheme-strstr.xml
grapheme-substr.xml
intl-error-name.xml
intl-get-error-code.xml
intl-get-error-message.xml
intl-is-failure.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/asort.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/asort.xml +++ phpdoc-fr/reference/intl/collator/asort.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.asort" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::asort</refname> <refname>collator_asort</refname> <refpurpose>Tri un tableau en conservant les clés, avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::asort</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_asort</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Cette fonction trie un tableau en maintenant l'association entre les clés et les valeurs. Elle sert surtout à trier des tableaux associatifs, où l'ordre des éléments est important. Les éléments seront triés en fonction des conventions locales. </para> <para> Ãquivalent de la fonction PHP standard <function>asort</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para>&array; de chaînes à trier.</para> </listitem> </varlistentry> <varlistentry> <term><parameter>sort_flag</parameter></term> <listitem> <para> Type de tri, optionnel, choisi parmi les constantes suivantes : </para> <para> <itemizedlist> <listitem> <para> <constant>Collator::SORT_REGULAR</constant> : compare les éléments normalement (pas de changement de type). </para> </listitem> <listitem> <para> <constant>Collator::SORT_NUMERIC</constant> : compare les éléments numériquement. </para> </listitem> <listitem> <para> <constant>Collator::SORT_STRING</constant> : compare les éléments littéralement. </para> </listitem> </itemizedlist> Le type de tri par défaut est <constant>Collator::SORT_REGULAR</constant>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_asort</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $arr = array( 'a' => '100', 'b' => '50', 'c' => '7' ); collator_asort( $coll, $arr, Collator::SORT_NUMERIC ); var_export( $arr ); collator_asort( $coll, $arr, Collator::SORT_STRING ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 'c' => '7', 'b' => '50', 'a' => '100', )array ( 'a' => '100', 'b' => '50', 'c' => '7', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_sort</function></member> <member><function>collator_sort_with_sort_keys</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/compare.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/compare.xml +++ phpdoc-fr/reference/intl/collator/compare.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.compare" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::compare</refname> <refname>collator_compare</refname> <refpurpose>Compare deux chaînes Unicode</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::compare</methodname> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_compare</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> Compare deux chaînes Unicode en fonction des règles de collation. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>str1</parameter></term> <listitem> <para> La première chaîne à comparer. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>str2</parameter></term> <listitem> <para> La deuxième chaîne à comparer. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>Résultats de comparaison</para> <para> <itemizedlist> <listitem> <para> 1 si <emphasis> str1</emphasis> est <emphasis> plus grand</emphasis> que <emphasis> str2</emphasis> ; </para> </listitem> <listitem> <para> 0 si <emphasis>str1</emphasis> est <emphasis>égal</emphasis> à <emphasis>str2</emphasis>; </para> </listitem> <listitem> <para> -1 si <emphasis> str1</emphasis> est <emphasis> plus petit</emphasis> que <emphasis> str2</emphasis> . </para> </listitem> </itemizedlist> En cas d'erreur, un &boolean; &false; est retourné. </para> &return.falseproblem; </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_compare</function></title> <programlisting role="php"> <![CDATA[ <?php $s1 = 'Hello'; $s2 = 'hello'; $coll = collator_create( 'en_US' ); $res = collator_compare( $coll, $s1, $s2 ); if ($res === false) { echo collator_get_error_message( $coll ); } else if( $res > 0 ) { echo "s1 est plus grand que s2\n"; } else if( $res < 0 ) { echo "s1 est plus petit que s2\n"; } else { echo "s1 est égal à s2\n"; ?> ]]> </programlisting> &example.outputs; <screen> s1 est plus grand que s2 </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_sort</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/construct.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/construct.xml +++ phpdoc-fr/reference/intl/collator/construct.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Collator::__construct</refname> <refpurpose>Créatin d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <constructorsynopsis> <methodname>Collator::__construct</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </constructorsynopsis> <para> Création d'une nouvelle instance d'un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>locale</parameter></term> <listitem> <para> La locale dont les règles de collation doivent être respectés. Des valeurs spéciales peuvent être passées dans cet argument : si &null; est passé, la locale par défaut sera utilisée. Si une chaîne vide ou le mot clé <literal>"root"</literal>, les règles UCA seront utilisées. </para> <para> L'attribut Locale est généralement l'attribut le plus important pour assurer des tris et comparaisons valides, en fonction des attentes des utilisateurs. L'ordre par défaut <link xlink:href="&url.icu.uca;">UCA</link> va trier uniquement quelques langues, telles que hollandais ou portugais (correctement signifie que le résultat sera conforme aux attentes des utilisateurs de ces langues). Autrement, vous devez fournir une locale adaptée à vos utilisateurs. Par conséquent, une valeur spécifique de locale doit être fournie pour assurer un service correct. Le choix de la locale va configurer les valeurs de tous ses attributs qui sont les plus pertinentes pour une locale. Par conséquent, la plupart du temps, les attributs n'ont pas besoin d'être d'être explicitement attribués. Dans le même temps, le choix de la locale aura un impact sur les performances de comparaison et de tris. <!-- In short attribute names, <language>_<script>_<region>_<keyword> is represented by: L<language>_Z<script>_R<region>_V<variant>_K<keyword>. for <emphasis>RFC4646</emphasis> locale naming. <example><title>Locale format</title> Example: Locale="sv" (Swedish) "Kypper" < "Köpfe" Locale="de" (German) "Köpfe" < "Kypper" </example> --> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Retourne un objet vide en cas d'erreur. Vous pouvez alors utiliser la méthode <function>intl_get_error_code</function> et / ou <function>intl_get_error_message</function> pour en savoir faire. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>Collator::__construct</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = new Collator( 'en_CA' ); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Collator::create</function></member> <member><function>collator_create</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/create.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/create.xml +++ phpdoc-fr/reference/intl/collator/create.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.create" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::create</refname> <refname>collator_create</refname> <refpurpose>Création d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <modifier>static</modifier> <type>Collator</type> <methodname>Collator::create</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>Collator</type> <methodname>collator_create</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </methodsynopsis> <para> Les chaînes seront comparées et triées avec des conventions locales. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>locale</parameter></term> <listitem> <para> La locale dont les règles de collation doivent être respectés. Des valeurs spéciales peuvent être passées dans cet argument : si &null; est passé, la locale par défaut sera utilisée. Si une chaîne vide ou le mot clé <literal>"root"</literal>, les règles UCA seront utilisées. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une nouvelle instance de la classe <classname>Collator</classname>, ou &null; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exmple avec <function>collator_create</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); if( !isset( $coll ) ) { printf( "Echec de création de collator : %s\n", intl_get_error_message() ); exit( 1 ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Collator::__construct</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-attribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-attribute.xml +++ phpdoc-fr/reference/intl/collator/get-attribute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getattribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getAttribute</refname> <refname>collator_get_attribute</refname> <refpurpose>Lit un attribut de collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getAttribute</methodname> <methodparam><type>int</type><parameter>attr</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_attribute</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>attr</parameter></methodparam> </methodsynopsis> <para> Lit un attribut de collation. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>attr</parameter></term> <listitem> <para> L'attribut à lire. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La valeur de l'attribut, ou &false; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_attribute</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_CA' ); $val = collator_get_attribute( $coll, Collator::NUMERIC_COLLATION ); if( $val === false ) { // Gestion d'erreur } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_set_attribute</function></member> <member><function>collator_get_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-error-code.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-error-code.xml +++ phpdoc-fr/reference/intl/collator/get-error-code.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.geterrorcode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getErrorCode</refname> <refname>collator_get_error_code</refname> <refpurpose>Lit la dernière erreur du collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getErrorCode</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_error_code</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le code d'erreur retourné par le dernier appel à un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_error_code</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); if( collator_get_attribute( $coll, Collator::FRENCH_COLLATION ) === false ) handle_error( collator_get_error_code() ); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-error-message.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-error-message.xml +++ phpdoc-fr/reference/intl/collator/get-error-message.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.geterrormessage" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getErrorMessage</refname> <refname>collator_get_error_message</refname> <refpurpose>Lit le dernier message d'erreur du collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>string</type> <methodname>Collator::getErrorMessage</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>string</type> <methodname>collator_get_error_message</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> Lit le dernier message d'erreur. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Object <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La description d'une erreur survenue lors du dernier appel à une méthode <classname>Collator</classname>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_error_message</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'lt' ); if( collator_compare( $coll, 'y', 'k' ) === false ) { echo collator_get_error_message( $coll ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_get_error_code</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-locale.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-locale.xml +++ phpdoc-fr/reference/intl/collator/get-locale.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getlocale" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getLocale</refname> <refname>collator_get_locale</refname> <refpurpose>Lit le nom de la locale d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>string</type> <methodname>Collator::getLocale</methodname> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>string</type> <methodname>collator_get_locale</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Lit le nom de la locale d'un collator </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>type</parameter></term> <listitem> <para> Vous pouvez choisir entre une valeur valide ou une valeur littérale de la locale (à l'aide des constantes <constant>Locale::VALID_LOCALE</constant> et <constant>Locale::ACTUAL_LOCALE</constant>, respectivement). La valeur par défaut est la valeur littérale. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le nom de la locale pour laquelle le collator est configuré. Si le collator a été configuré à partir de règles, ou qu'une erreur est survenue, la méthode retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_locale</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US_California' ); $res_val = collator_get_locale( $coll, Locale::VALID_LOCALE ); $res_act = collator_get_locale( $coll, Locale::ACTUAL_LOCALE ); printf( "Valid locale name: %s\nActual locale name: %s\n", $res_req, $res_val, $res_act ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Requested locale name: en_US_California Valid locale name: en_US Actual locale name: en ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_create</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-strength.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-strength.xml +++ phpdoc-fr/reference/intl/collator/get-strength.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getstrength" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getStrength</refname> <refname>collator_get_strength</refname> <refpurpose>Get current collation strength</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getStrength</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_strength</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la Strength de la collation, ou &false; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_strength</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $strength = collator_get_strength( $coll ); ?> ]]> </programlisting> <!-- &example.outputs; <screen> <![CDATA[ // TODO ]]> </screen> --> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_set_strength</function></member> <member><function>collator_get_attribute</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/set-attribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/set-attribute.xml +++ phpdoc-fr/reference/intl/collator/set-attribute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.setattribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::setAttribute</refname> <refname>collator_set_attribute</refname> <refpurpose>Configure l'attribut de collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::setAttribute</methodname> <methodparam><type>int</type><parameter>attr</parameter></methodparam> <methodparam><type>int</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_set_attribute</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>attr</parameter></methodparam> <methodparam><type>int</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>attr</parameter></term> <listitem> <para>L'attribut.</para> </listitem> </varlistentry> <varlistentry> <term><parameter>val</parameter></term> <listitem> <para> La valeur de l'attribute. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_set_attribute</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_CA' ); $val = collator_get_attribute( $coll, Collator::NUMERIC_COLLATION ); if ($val === false) { // Gestion d'erreur. } elseif ($val === Collator::ON) { // Quelque chose d'utile } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_get_attribute</function></member> <member><function>collator_set_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/set-strength.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/set-strength.xml +++ phpdoc-fr/reference/intl/collator/set-strength.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.setstrength" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Collator::setStrength</refname> <refname>collator_set_strength</refname> <refpurpose>Set collation strength</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::setStrength</methodname> <methodparam><type>int</type><parameter>strength</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_set_strength</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>strength</parameter></methodparam> </methodsynopsis> <para> Le service de collation ICU suporte de nombreux niveaux de comparaison (appelés "Levels", mais aussi connus sous le nom de "Strengths"). Avec ces categories, ICU peut trier les chaînes avec précision, en fonction des conventions locales. Cependant, en permettant l'utilisation selective des niveaux, la recherche d'une chaîne dans un texte peut être réalisées, à partir de différentes conditions. Pour plus d'informations, voyez le chapitre <function>collator_set_strength</function>. </para> <para> <orderedlist> <listitem> <para> <emphasis> Niveau primaire</emphasis> : Typiquement, ceci est utilisé pour faire la différence entre des caractères de bases, comme "a" < "b"). C'est la différence la plus importante. Par exemple, les dictionnaires sont divisées en sections avec les caractères de base. C'est le niveau 1. </para> </listitem> <listitem> <para> <emphasis> Niveau secondaire</emphasis> : Les accents sur les caractères sont considérés comme des différences secondaires. Par exemple, "as" < "à s" < "at". D'autres différences entre les caractères peuvent être considérées comme secondaires, en fonction des langues. Une différence secondaire sont toujours ignorées quand une différence primaire est présente. C'est le niveau 2. <note> <para> Note : dans certaines langues, comme le danois, certains caractères accentués sont considérés comme des caractères de bases. Dans la plupart des langues, un caractère accentué est simplement une différence secondaire avec les versions simple de la lettre. </para> </note> </para> </listitem> <listitem> <para> <emphasis> Niveau tertiaire</emphasis> : les majuscules et les minuscules sont distinguées au niveau tertiaire. par exemple, "ao" < "Ao" < "aò". De plus, une variante d'une lettre est différente de la forme de base, au niveau ternaire. Par exemple, "A" et " ". Un autre exemple de différente tertiaire est le grand et le petit Kana. Une différence tertiaire est ignorée quand une différence primaire ou secondaire est présente. C'est le niveau 3. </para> </listitem> <listitem> <para> <emphasis> Niveau quaternaire </emphasis>: Lorsque le ponctuation est ignorée, au niveau 13, un niveau supplémentaire peut être utilisé pour distinguer des mots avec ou sans ponctuation. Par exemple, "ab" < "a-b" < "aB". Cette différence est ignorée lorsqu'il y a une différence de niveau primaire, secondaire ou tertiaire. Le niveau quaternaire ne doit être utilisé que lorsqu'il faut ignorer la ponctuation ou traiter des mots japonais (traitement Hiragana). </para> </listitem> <listitem> <para> <emphasis> Niveau identique</emphasis> : Lorsque tous les autres niveaux sont égaux, le niveau identique est utilisé pour départager les caractères. Le code Unicode point sur une forme NFD de chaque caractère, et sont comparés à ce niveau, au cas où il n'y aurait pas de différence au niveau 14. Par exemple, les cantilliation de l'hébreux ne sont distingués qu'à ce niveau. Ce niveau ne doit être utilisé qu'avec beaucoup de parcimonie, car il fait substantiellement décroitre les performances. Il est connu sous le nom de niveau 5. </para> </listitem> </orderedlist> </para> <para> Par exemple, on peut choisir d'ignorer les accents, les accents et les majuscules dans un texte. Presque tous les caractères sont distingués par les trois premiers niveaux, et la plupart des locales s'arrêtent au niveau trois. Cependant, si l'attribut Alternate prend la valeur de Shifted, alors le quatrième niveau sert à départager les égalités entre les espaces, la ponctuation et les symboles, qui seraient ignorés autrement. Si des différentes très subtiles sont nécessaires entre les caractères, le niveau identique peut être utilisée (par exemple, le niveau identique fait la différence entre un A mathématique petit et gras avec un A mathématique italique et petit. Cependant, utiliser ces niveaux implique une dégradation significative des performances lors de la comparaison et le tri des chaînes proches ou égales. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>strength</parameter></term> <listitem> <para>Le niveau à choisir.</para> <para> Les valeurs possibles sont : <itemizedlist> <listitem> <para> <constant>Collator::PRIMARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::SECONDARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::TERTIARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::QUATERNARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::IDENTICAL</constant> </para> </listitem> <listitem> <para> <constant>Collator::DEFAULT</constant> </para> </listitem> </itemizedlist> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_set_strength</function></title> <programlisting role="php"> <![CDATA[ <?php $arr = array( 'aò', 'Ao', 'ao' ); $coll = collator_create( 'en_US' ); // Trie un tableau avec le niveau par défaut collator_sort( $coll, $arr ); var_export( $arr ); // Tri un tableau avec le niveau primaire collator_set_strength( $coll, Collator::PRIMARY ); collator_sort( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'ao', 1 => 'Ao', 2 => 'aò', ) array ( 0 => 'aò', 1 => 'Ao', 2 => 'ao', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_get_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml +++ phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.sortwithsortkeys" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::sortWithSortKeys</refname> <refname>collator_sort_with_sort_keys</refname> <refpurpose>Tri un tableau et ses clés avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::sortWithSortKeys</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_sort_with_sort_keys</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> </methodsynopsis> <para> Similaire à <function>collator_sort</function>, mais utilise le tri de clé ICU de <function>ucol_getSortKey</function> pour obtenir plus de vitesse sur les grands tableaux. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para>&array; de chaîne à trier</para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_sort_with_sort_keys</function></title> <programlisting role="php"> <![CDATA[ <?php $arr = array( 'Köpfe', 'Kypper', 'Kopfe' ); $coll = collator_create( 'sv' ); collator_sort_with_sort_keys( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'Kopfe', 1 => 'Kypper', 2 => 'Köpfe', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_sort</function></member> <member><function>collator_asort</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/sort.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/sort.xml +++ phpdoc-fr/reference/intl/collator/sort.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.sort" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::sort</refname> <refname>collator_sort</refname> <refpurpose>Tri un tableau avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::sort</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_sort</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Cette fonction trie un tableau en fonction des conventions locales. </para> <para> Ãquivalent à la fonction standard PHP <function>sort</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para> &array; de chaînes à trier. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>sort_flag</parameter></term> <listitem> <para> Type de tri, optionnel, choisi parmi les constantes suivantes : </para> <para> <itemizedlist> <listitem> <para> <constant>Collator::SORT_REGULAR</constant> : compare les éléments normalement (pas de changement de type). </para> </listitem> <listitem> <para> <constant>Collator::SORT_NUMERIC</constant> : compare les éléments numériquement. </para> </listitem> <listitem> <para> <constant>Collator::SORT_STRING</constant> : compare les éléments littéralement. </para> </listitem> </itemizedlist> Le type de tri par défaut est <constant>Collator::SORT_REGULAR</constant>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_sort</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $arr = array( 'at', 'à s', 'as' ); var_export( $arr ); collator_sort( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'at', 1 => 'à s', 2 => 'as', )array ( 0 => 'as', 1 => 'à s', 2 => 'at', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_asort</function></member> <member><function>collator_sort_with_sort_keys</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-extract.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-extract.xml +++ phpdoc-fr/reference/intl/functions/grapheme-extract.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-extract" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_extract</refname> <refpurpose>Extrait un groupe de graphème d'une chaîne UTF-8</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_extract</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>int</type><parameter>size</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>extract_type</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>start</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter role="reference">next</parameter></methodparam> </methodsynopsis> <para> Cette fonction extrait une séquence de groupes de graphèmes par défaut d'un texte en UTF-8. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>size</parameter></term> <listitem> <para> Le nombre maximal d'élément, en fonction de $extract_type, à retourner. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extract_type</parameter></term> <listitem> <para> Défini le type d'unités indiquées par le paramètre $size : </para> <para> <simplelist> <member>GRAPHEME_EXTR_COUNT (par défaut) : $size est le nombre de groupe de graphèmes à extraire.</member> <member>GRAPHEME_EXTR_MAXBYTES : $size est le nombre d'octets à retourner.</member> <member>GRAPHEME_EXTR_MAXCHARS : $size est le nombre de caractères UTF-8 à retourner.</member> </simplelist> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>start</parameter></term> <listitem> <para> La position de début dans $haystack, exprimée en octets. Elle doit être positive, nulle ou inférieure à la taille de $haystack en octets. La valeur par défaut est zéro. Si $start ne correspond pas au premier octets d'un caractère UTF-8 valide, la position de démarrage sera déplacée au prochain octet valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>next</parameter></term> <listitem> <para> Référence à une variable qui recevra la prochaine position de début valide. Lorsque la fonction se termine, cela peut être une position qui est au dela de la taille de la chaîne. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Une chaîne qui débute à la position $start et se termine à la limite valide d'un graphème, et qui se conformen aux conditions $size et $extract_type. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_extract</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_extract( $char_a_ring_nfd . $char_o_diaeresis_nfd, 1, GRAPHEME_EXTR_COUNT, 2)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_substr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-stripos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-stripos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-stripos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-stripos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_stripos</refname> <refpurpose>Trouve la position en graphème de la première occurrence dans une chaîne, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_stripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position en graphème de la première occurrence dans une chaîne, en effectuant une recherche insensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la position, sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_stripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_stripos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-stristr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-stristr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-stristr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-stristr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_stristr</refname> <refpurpose>Retourne la partie d'une chaîne à partir d'une occurrence</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_stristr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>before_needle</parameter></methodparam> </methodsynopsis> <para> Retourne la partie d'une chaîne à partir de la première occurrence de <parameter>needle</parameter> (insensible à la casse), et jusqu'à la fin de la chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>before_needle</parameter></term> <listitem> <para> Si &true;, <function>grapheme_stristr<function> retourne la partie de $haystack avant la première occurrence. Par défaut, ce paramètre vaut &false; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une portion de $haystack, ou &false; si $needle n'est pas trouvé. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title><function>grapheme_stristr</function> example</title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_O_diaeresis_nfd)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88a%CC%8A ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strlen.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strlen.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strlen.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strlen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strlen</refname> <refpurpose>Lit la taille d'une chaîne en nombre de graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strlen</methodname> <methodparam><type>string</type><parameter>input</parameter></methodparam> </methodsynopsis> <para> Lit la taille d'une chaîne en nombre de graphème (et non pas en octets ou caractères). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>input</parameter></term> <listitem> <para> La chaîne à mesurer. Elle doit être une chaîne UTF-8 valide. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La taille de la chaîne, et 0 si la chaîne est vide. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strlen</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 6 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strpos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strpos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strpos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strpos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strpos</refname> <refpurpose>Trouve la position du premier graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du permier graphème dans une chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strpos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strpos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strripos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strripos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strripos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strripos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strripos</refname> <refpurpose>Trouve la position du dernier graphème, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du dernier graphème, en effectuant une recherche insensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strripos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print grapheme_strripos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strrpos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strrpos</refname> <refpurpose>Trouve la position du dernier graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strrpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du dernier graphème, en effectuant une recherche sensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strrpos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strrpos</function></title> <programlisting role="php"> <![CDATA[ < ?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strrpos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strstr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strstr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strstr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strstr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strstr</refname> <refpurpose>Retourne la partie d'une chaîne à partir d'une occurrence, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_strstr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>before_needle</parameter></methodparam> </methodsynopsis> <para> Retourne la partie d'une chaîne à partir de la première occurrence de <parameter>needle</parameter> (sensible à la casse), et jusqu'à la fin de la chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>before_needle</parameter></term> <listitem> <para> Si &true;, <function>grapheme_strstr<function> retourne la partie de $haystack avant la première occurrence. Par défaut, ce paramètre vaut &false; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of string, or FALSE if needle is not found. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title><function>grapheme_strstr</function> example</title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_o_diaeresis_nfd)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88a%CC%8A ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stristr</function></member> <member><function>grapheme_stripos</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-substr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-substr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-substr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-substr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_substr</refname> <refpurpose>Retourne une partie d'une chaîne</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_substr</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam><type>int</type><parameter>start</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Retourne une partie d'une chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>string</parameter></term> <listitem> <para> La chaîne à couper. Doit être UTF-8 et valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>start</parameter></term> <listitem> <para> La position de début, en unité par de graphèmes. Si $start est non-négatif, la chaîne retournée va commencer à la position $start dans la chaîne, en comptant à partir de 0. Si $start est négatif, la chaîne retournée va commencer à la position $start en comptant depuis la fin de la chaîne. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>length</parameter></term> <listitem> <para> La taille de la sous-chaîne à extraire, en unités de graphème. Si $length est donné et positif, la chaîne retournée va contenir au plus $length graphèmes, commençant à $start (en fonction de la taille de la chaîne). Si $string est inférieur ou égal à $start graphèmes de long, &false; sera retourné. Si $length a une valeur négative, alors autant de graphème seront omis à partir de la fin de la chaîne (après que la position de début ait été calculé, lorsque $start est aussi négatif). Si $start dénote une position au-dela de la fin de la chaîne, une chaîne vide sera retournée. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la partie de chaîne extraite de $string. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_substr</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 )); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ a%CC%8Abco%CC%88 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_extract</function></member> <member><function>grapheme_extractB</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-error-name.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-error-name.xml +++ phpdoc-fr/reference/intl/functions/intl-error-name.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-error-name"> <refnamediv> <refname>intl_error_name</refname> <refpurpose>Lit le nom symbolique d'un code d'erreur donné</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type> <methodname>intl_error_name</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> Retourne le nom du code d'erreur ICU. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>error_code</parameter></term> <listitem> <para> Le code d'erreur ICU. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La chaîne retournée sera celui du nom de la constante équivalente. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_error_name</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_RU' ); $err_code = collator_get_error_code( $coll ); printf( "Le nom symbolique de %d est %s\n.", $err_code, intl_error_name( $err_code ) ); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Symbolic name for -128 is U_USING_FALLBACK_WARNING. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_is_failure</function></member> <member><function>intl_get_error_code</function></member> <member><function>intl_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-get-error-code.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-get-error-code.xml +++ phpdoc-fr/reference/intl/functions/intl-get-error-code.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-get-error-code"> <refnamediv> <refname>intl_get_error_code</refname> <refpurpose>Lit le dernier code d'erreur</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type> <methodname>intl_get_error_code</methodname> <void /> </methodsynopsis> <para> Pratique pour gérer les erreurs qui surviennent dans les méthodes statiques quand il n'y a pas d'objet dont on peut obtenir le message d'erreur. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le code d'erreur retourné par le dernier appel à l'API. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_get_error_code</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( '<bad_param>' ); if( !$coll ) { handle_error( intl_get_error_code() ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_is_failure</function></member> <member><function>intl_error_name</function></member> <member><function>intl_get_error_message</function></member> <member><function>collator_get_error_code</function></member> <member><function>numfmt_get_error_code</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-get-error-message.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-get-error-message.xml +++ phpdoc-fr/reference/intl/functions/intl-get-error-message.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-get-error-message"> <refnamediv> <refname>intl_get_error_message</refname> <refpurpose>Lit la description de la dernière erreur</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type> <methodname>intl_get_error_message</methodname> <void /> </methodsynopsis> <para> Lit le message d'erreur de la dernière fonction d'internationalisation appelée. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La description de l'erreur qui est survenue durant le dernier appel de l'API. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_get_error_message</function></title> <programlisting role="php"> <![CDATA[ <?php if( Collator::getAvailableLocales() === false ) { show_error( intl_get_error_message() ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_error_name</function></member> <member><function>intl_get_error_code</function></member> <member><function>intl_is_failure</function></member> <member><function>collator_get_error_message</function></member> <member><function>numfmt_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-is-failure.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-is-failure.xml +++ phpdoc-fr/reference/intl/functions/intl-is-failure.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-is-failure"> <refnamediv> <refname>intl_is_failure</refname> <refpurpose>Vérifie si un code d'erreur indique un échec</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type> <methodname>intl_is_failure</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>error_code</parameter></term> <listitem> <para> une valeur retournée par une des fonctions <function>intl_get_error_code</function>, <function>collator_get_error_code</function> . </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le code indique un échec, et &false; dans le cas d'une réussite ou d'une alerte. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_is_failure</function></title> <programlisting role="php"> <![CDATA[ <?php function check( $err_code ) { var_export( intl_is_failure( $err_code ) ); echo "\n"; } check( U_ZERO_ERROR ); check( U_USING_FALLBACK_WARNING ); check( U_ILLEGAL_ARGUMENT_ERROR ); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ false false true ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_get_error_code</function></member> <member><function>collator_get_error_code</function></member> <member><function>Collator-getErrorCode</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/asort.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/asort.xml +++ phpdoc-fr/reference/intl/collator/asort.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.asort" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::asort</refname> <refname>collator_asort</refname> <refpurpose>Tri un tableau en conservant les clés, avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::asort</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_asort</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Cette fonction trie un tableau en maintenant l'association entre les clés et les valeurs. Elle sert surtout à trier des tableaux associatifs, où l'ordre des éléments est important. Les éléments seront triés en fonction des conventions locales. </para> <para> Ãquivalent de la fonction PHP standard <function>asort</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para>&array; de chaînes à trier.</para> </listitem> </varlistentry> <varlistentry> <term><parameter>sort_flag</parameter></term> <listitem> <para> Type de tri, optionnel, choisi parmi les constantes suivantes : </para> <para> <itemizedlist> <listitem> <para> <constant>Collator::SORT_REGULAR</constant> : compare les éléments normalement (pas de changement de type). </para> </listitem> <listitem> <para> <constant>Collator::SORT_NUMERIC</constant> : compare les éléments numériquement. </para> </listitem> <listitem> <para> <constant>Collator::SORT_STRING</constant> : compare les éléments littéralement. </para> </listitem> </itemizedlist> Le type de tri par défaut est <constant>Collator::SORT_REGULAR</constant>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_asort</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $arr = array( 'a' => '100', 'b' => '50', 'c' => '7' ); collator_asort( $coll, $arr, Collator::SORT_NUMERIC ); var_export( $arr ); collator_asort( $coll, $arr, Collator::SORT_STRING ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 'c' => '7', 'b' => '50', 'a' => '100', )array ( 'a' => '100', 'b' => '50', 'c' => '7', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_sort</function></member> <member><function>collator_sort_with_sort_keys</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/compare.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/compare.xml +++ phpdoc-fr/reference/intl/collator/compare.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.compare" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::compare</refname> <refname>collator_compare</refname> <refpurpose>Compare deux chaînes Unicode</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::compare</methodname> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_compare</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> Compare deux chaînes Unicode en fonction des règles de collation. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>str1</parameter></term> <listitem> <para> La première chaîne à comparer. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>str2</parameter></term> <listitem> <para> La deuxième chaîne à comparer. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>Résultats de comparaison</para> <para> <itemizedlist> <listitem> <para> 1 si <emphasis> str1</emphasis> est <emphasis> plus grand</emphasis> que <emphasis> str2</emphasis> ; </para> </listitem> <listitem> <para> 0 si <emphasis>str1</emphasis> est <emphasis>égal</emphasis> à <emphasis>str2</emphasis>; </para> </listitem> <listitem> <para> -1 si <emphasis> str1</emphasis> est <emphasis> plus petit</emphasis> que <emphasis> str2</emphasis> . </para> </listitem> </itemizedlist> En cas d'erreur, un &boolean; &false; est retourné. </para> &return.falseproblem; </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_compare</function></title> <programlisting role="php"> <![CDATA[ <?php $s1 = 'Hello'; $s2 = 'hello'; $coll = collator_create( 'en_US' ); $res = collator_compare( $coll, $s1, $s2 ); if ($res === false) { echo collator_get_error_message( $coll ); } else if( $res > 0 ) { echo "s1 est plus grand que s2\n"; } else if( $res < 0 ) { echo "s1 est plus petit que s2\n"; } else { echo "s1 est égal à s2\n"; ?> ]]> </programlisting> &example.outputs; <screen> s1 est plus grand que s2 </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_sort</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/construct.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/construct.xml +++ phpdoc-fr/reference/intl/collator/construct.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Collator::__construct</refname> <refpurpose>Créatin d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <constructorsynopsis> <methodname>Collator::__construct</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </constructorsynopsis> <para> Création d'une nouvelle instance d'un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>locale</parameter></term> <listitem> <para> La locale dont les règles de collation doivent être respectés. Des valeurs spéciales peuvent être passées dans cet argument : si &null; est passé, la locale par défaut sera utilisée. Si une chaîne vide ou le mot clé <literal>"root"</literal>, les règles UCA seront utilisées. </para> <para> L'attribut Locale est généralement l'attribut le plus important pour assurer des tris et comparaisons valides, en fonction des attentes des utilisateurs. L'ordre par défaut <link xlink:href="&url.icu.uca;">UCA</link> va trier uniquement quelques langues, telles que hollandais ou portugais (correctement signifie que le résultat sera conforme aux attentes des utilisateurs de ces langues). Autrement, vous devez fournir une locale adaptée à vos utilisateurs. Par conséquent, une valeur spécifique de locale doit être fournie pour assurer un service correct. Le choix de la locale va configurer les valeurs de tous ses attributs qui sont les plus pertinentes pour une locale. Par conséquent, la plupart du temps, les attributs n'ont pas besoin d'être d'être explicitement attribués. Dans le même temps, le choix de la locale aura un impact sur les performances de comparaison et de tris. <!-- In short attribute names, <language>_<script>_<region>_<keyword> is represented by: L<language>_Z<script>_R<region>_V<variant>_K<keyword>. for <emphasis>RFC4646</emphasis> locale naming. <example><title>Locale format</title> Example: Locale="sv" (Swedish) "Kypper" < "Köpfe" Locale="de" (German) "Köpfe" < "Kypper" </example> --> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Retourne un objet vide en cas d'erreur. Vous pouvez alors utiliser la méthode <function>intl_get_error_code</function> et / ou <function>intl_get_error_message</function> pour en savoir faire. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>Collator::__construct</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = new Collator( 'en_CA' ); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Collator::create</function></member> <member><function>collator_create</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/create.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/create.xml +++ phpdoc-fr/reference/intl/collator/create.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.create" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::create</refname> <refname>collator_create</refname> <refpurpose>Création d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <modifier>static</modifier> <type>Collator</type> <methodname>Collator::create</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>Collator</type> <methodname>collator_create</methodname> <methodparam><type>string</type><parameter>locale</parameter></methodparam> </methodsynopsis> <para> Les chaînes seront comparées et triées avec des conventions locales. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>locale</parameter></term> <listitem> <para> La locale dont les règles de collation doivent être respectés. Des valeurs spéciales peuvent être passées dans cet argument : si &null; est passé, la locale par défaut sera utilisée. Si une chaîne vide ou le mot clé <literal>"root"</literal>, les règles UCA seront utilisées. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une nouvelle instance de la classe <classname>Collator</classname>, ou &null; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exmple avec <function>collator_create</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); if( !isset( $coll ) ) { printf( "Echec de création de collator : %s\n", intl_get_error_message() ); exit( 1 ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Collator::__construct</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-attribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-attribute.xml +++ phpdoc-fr/reference/intl/collator/get-attribute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getattribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getAttribute</refname> <refname>collator_get_attribute</refname> <refpurpose>Lit un attribut de collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getAttribute</methodname> <methodparam><type>int</type><parameter>attr</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_attribute</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>attr</parameter></methodparam> </methodsynopsis> <para> Lit un attribut de collation. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>attr</parameter></term> <listitem> <para> L'attribut à lire. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La valeur de l'attribut, ou &false; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_attribute</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_CA' ); $val = collator_get_attribute( $coll, Collator::NUMERIC_COLLATION ); if( $val === false ) { // Gestion d'erreur } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_set_attribute</function></member> <member><function>collator_get_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-error-code.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-error-code.xml +++ phpdoc-fr/reference/intl/collator/get-error-code.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.geterrorcode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getErrorCode</refname> <refname>collator_get_error_code</refname> <refpurpose>Lit la dernière erreur du collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getErrorCode</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_error_code</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le code d'erreur retourné par le dernier appel à un objet <classname>Collator</classname>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_error_code</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); if( collator_get_attribute( $coll, Collator::FRENCH_COLLATION ) === false ) handle_error( collator_get_error_code() ); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-error-message.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-error-message.xml +++ phpdoc-fr/reference/intl/collator/get-error-message.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.geterrormessage" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getErrorMessage</refname> <refname>collator_get_error_message</refname> <refpurpose>Lit le dernier message d'erreur du collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>string</type> <methodname>Collator::getErrorMessage</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>string</type> <methodname>collator_get_error_message</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> Lit le dernier message d'erreur. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Object <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La description d'une erreur survenue lors du dernier appel à une méthode <classname>Collator</classname>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_error_message</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'lt' ); if( collator_compare( $coll, 'y', 'k' ) === false ) { echo collator_get_error_message( $coll ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_get_error_code</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-locale.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-locale.xml +++ phpdoc-fr/reference/intl/collator/get-locale.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getlocale" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getLocale</refname> <refname>collator_get_locale</refname> <refpurpose>Lit le nom de la locale d'un collator</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>string</type> <methodname>Collator::getLocale</methodname> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>string</type> <methodname>collator_get_locale</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Lit le nom de la locale d'un collator </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>type</parameter></term> <listitem> <para> Vous pouvez choisir entre une valeur valide ou une valeur littérale de la locale (à l'aide des constantes <constant>Locale::VALID_LOCALE</constant> et <constant>Locale::ACTUAL_LOCALE</constant>, respectivement). La valeur par défaut est la valeur littérale. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le nom de la locale pour laquelle le collator est configuré. Si le collator a été configuré à partir de règles, ou qu'une erreur est survenue, la méthode retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_locale</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US_California' ); $res_val = collator_get_locale( $coll, Locale::VALID_LOCALE ); $res_act = collator_get_locale( $coll, Locale::ACTUAL_LOCALE ); printf( "Valid locale name: %s\nActual locale name: %s\n", $res_req, $res_val, $res_act ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Requested locale name: en_US_California Valid locale name: en_US Actual locale name: en ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>collator_create</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/get-strength.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/get-strength.xml +++ phpdoc-fr/reference/intl/collator/get-strength.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.getstrength" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::getStrength</refname> <refname>collator_get_strength</refname> <refpurpose>Get current collation strength</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>int</type> <methodname>Collator::getStrength</methodname> <void /> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>int</type> <methodname>collator_get_strength</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la Strength de la collation, ou &false; en cas d'erreur. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_get_strength</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $strength = collator_get_strength( $coll ); ?> ]]> </programlisting> <!-- &example.outputs; <screen> <![CDATA[ // TODO ]]> </screen> --> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_set_strength</function></member> <member><function>collator_get_attribute</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/set-attribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/set-attribute.xml +++ phpdoc-fr/reference/intl/collator/set-attribute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.setattribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::setAttribute</refname> <refname>collator_set_attribute</refname> <refpurpose>Configure l'attribut de collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::setAttribute</methodname> <methodparam><type>int</type><parameter>attr</parameter></methodparam> <methodparam><type>int</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_set_attribute</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>attr</parameter></methodparam> <methodparam><type>int</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>attr</parameter></term> <listitem> <para>L'attribut.</para> </listitem> </varlistentry> <varlistentry> <term><parameter>val</parameter></term> <listitem> <para> La valeur de l'attribute. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_set_attribute</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_CA' ); $val = collator_get_attribute( $coll, Collator::NUMERIC_COLLATION ); if ($val === false) { // Gestion d'erreur. } elseif ($val === Collator::ON) { // Quelque chose d'utile } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="intl.collator-constants"><classname>Collator</classname> constants</link></member> <member><function>collator_get_attribute</function></member> <member><function>collator_set_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/set-strength.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/set-strength.xml +++ phpdoc-fr/reference/intl/collator/set-strength.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.setstrength" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Collator::setStrength</refname> <refname>collator_set_strength</refname> <refpurpose>Set collation strength</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::setStrength</methodname> <methodparam><type>int</type><parameter>strength</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_set_strength</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>int</type><parameter>strength</parameter></methodparam> </methodsynopsis> <para> Le service de collation ICU suporte de nombreux niveaux de comparaison (appelés "Levels", mais aussi connus sous le nom de "Strengths"). Avec ces categories, ICU peut trier les chaînes avec précision, en fonction des conventions locales. Cependant, en permettant l'utilisation selective des niveaux, la recherche d'une chaîne dans un texte peut être réalisées, à partir de différentes conditions. Pour plus d'informations, voyez le chapitre <function>collator_set_strength</function>. </para> <para> <orderedlist> <listitem> <para> <emphasis> Niveau primaire</emphasis> : Typiquement, ceci est utilisé pour faire la différence entre des caractères de bases, comme "a" < "b"). C'est la différence la plus importante. Par exemple, les dictionnaires sont divisées en sections avec les caractères de base. C'est le niveau 1. </para> </listitem> <listitem> <para> <emphasis> Niveau secondaire</emphasis> : Les accents sur les caractères sont considérés comme des différences secondaires. Par exemple, "as" < "à s" < "at". D'autres différences entre les caractères peuvent être considérées comme secondaires, en fonction des langues. Une différence secondaire sont toujours ignorées quand une différence primaire est présente. C'est le niveau 2. <note> <para> Note : dans certaines langues, comme le danois, certains caractères accentués sont considérés comme des caractères de bases. Dans la plupart des langues, un caractère accentué est simplement une différence secondaire avec les versions simple de la lettre. </para> </note> </para> </listitem> <listitem> <para> <emphasis> Niveau tertiaire</emphasis> : les majuscules et les minuscules sont distinguées au niveau tertiaire. par exemple, "ao" < "Ao" < "aò". De plus, une variante d'une lettre est différente de la forme de base, au niveau ternaire. Par exemple, "A" et " ". Un autre exemple de différente tertiaire est le grand et le petit Kana. Une différence tertiaire est ignorée quand une différence primaire ou secondaire est présente. C'est le niveau 3. </para> </listitem> <listitem> <para> <emphasis> Niveau quaternaire </emphasis>: Lorsque le ponctuation est ignorée, au niveau 13, un niveau supplémentaire peut être utilisé pour distinguer des mots avec ou sans ponctuation. Par exemple, "ab" < "a-b" < "aB". Cette différence est ignorée lorsqu'il y a une différence de niveau primaire, secondaire ou tertiaire. Le niveau quaternaire ne doit être utilisé que lorsqu'il faut ignorer la ponctuation ou traiter des mots japonais (traitement Hiragana). </para> </listitem> <listitem> <para> <emphasis> Niveau identique</emphasis> : Lorsque tous les autres niveaux sont égaux, le niveau identique est utilisé pour départager les caractères. Le code Unicode point sur une forme NFD de chaque caractère, et sont comparés à ce niveau, au cas où il n'y aurait pas de différence au niveau 14. Par exemple, les cantilliation de l'hébreux ne sont distingués qu'à ce niveau. Ce niveau ne doit être utilisé qu'avec beaucoup de parcimonie, car il fait substantiellement décroitre les performances. Il est connu sous le nom de niveau 5. </para> </listitem> </orderedlist> </para> <para> Par exemple, on peut choisir d'ignorer les accents, les accents et les majuscules dans un texte. Presque tous les caractères sont distingués par les trois premiers niveaux, et la plupart des locales s'arrêtent au niveau trois. Cependant, si l'attribut Alternate prend la valeur de Shifted, alors le quatrième niveau sert à départager les égalités entre les espaces, la ponctuation et les symboles, qui seraient ignorés autrement. Si des différentes très subtiles sont nécessaires entre les caractères, le niveau identique peut être utilisée (par exemple, le niveau identique fait la différence entre un A mathématique petit et gras avec un A mathématique italique et petit. Cependant, utiliser ces niveaux implique une dégradation significative des performances lors de la comparaison et le tri des chaînes proches ou égales. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>strength</parameter></term> <listitem> <para>Le niveau à choisir.</para> <para> Les valeurs possibles sont : <itemizedlist> <listitem> <para> <constant>Collator::PRIMARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::SECONDARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::TERTIARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::QUATERNARY</constant> </para> </listitem> <listitem> <para> <constant>Collator::IDENTICAL</constant> </para> </listitem> <listitem> <para> <constant>Collator::DEFAULT</constant> </para> </listitem> </itemizedlist> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_set_strength</function></title> <programlisting role="php"> <![CDATA[ <?php $arr = array( 'aò', 'Ao', 'ao' ); $coll = collator_create( 'en_US' ); // Trie un tableau avec le niveau par défaut collator_sort( $coll, $arr ); var_export( $arr ); // Tri un tableau avec le niveau primaire collator_set_strength( $coll, Collator::PRIMARY ); collator_sort( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'ao', 1 => 'Ao', 2 => 'aò', ) array ( 0 => 'aò', 1 => 'Ao', 2 => 'ao', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_get_strength</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml +++ phpdoc-fr/reference/intl/collator/sort-with-sort-keys.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.sortwithsortkeys" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::sortWithSortKeys</refname> <refname>collator_sort_with_sort_keys</refname> <refpurpose>Tri un tableau et ses clés avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::sortWithSortKeys</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_sort_with_sort_keys</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> </methodsynopsis> <para> Similaire à <function>collator_sort</function>, mais utilise le tri de clé ICU de <function>ucol_getSortKey</function> pour obtenir plus de vitesse sur les grands tableaux. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para>&array; de chaîne à trier</para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_sort_with_sort_keys</function></title> <programlisting role="php"> <![CDATA[ <?php $arr = array( 'Köpfe', 'Kypper', 'Kopfe' ); $coll = collator_create( 'sv' ); collator_sort_with_sort_keys( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'Kopfe', 1 => 'Kypper', 2 => 'Köpfe', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_sort</function></member> <member><function>collator_asort</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/collator/sort.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/collator/sort.xml +++ phpdoc-fr/reference/intl/collator/sort.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="collator.sort" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>Collator::sort</refname> <refname>collator_sort</refname> <refpurpose>Tri un tableau avec une collation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Style orienté objet </para> <methodsynopsis> <type>bool</type> <methodname>Collator::sort</methodname> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Style procédural </para> <methodsynopsis> <type>bool</type> <methodname>collator_sort</methodname> <methodparam><type>Collator</type><parameter>coll</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flag</parameter></methodparam> </methodsynopsis> <para> Cette fonction trie un tableau en fonction des conventions locales. </para> <para> Ãquivalent à la fonction standard PHP <function>sort</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>coll</parameter></term> <listitem> <para> Objet <classname>Collator</classname>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>arr</parameter></term> <listitem> <para> &array; de chaînes à trier. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>sort_flag</parameter></term> <listitem> <para> Type de tri, optionnel, choisi parmi les constantes suivantes : </para> <para> <itemizedlist> <listitem> <para> <constant>Collator::SORT_REGULAR</constant> : compare les éléments normalement (pas de changement de type). </para> </listitem> <listitem> <para> <constant>Collator::SORT_NUMERIC</constant> : compare les éléments numériquement. </para> </listitem> <listitem> <para> <constant>Collator::SORT_STRING</constant> : compare les éléments littéralement. </para> </listitem> </itemizedlist> Le type de tri par défaut est <constant>Collator::SORT_REGULAR</constant>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>collator_sort</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_US' ); $arr = array( 'at', 'à s', 'as' ); var_export( $arr ); collator_sort( $coll, $arr ); var_export( $arr ); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array ( 0 => 'at', 1 => 'à s', 2 => 'as', )array ( 0 => 'as', 1 => 'à s', 2 => 'at', ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member>Constantes <link linkend="intl.collator-constants"><classname>Collator</classname></link></member> <member><function>collator_asort</function></member> <member><function>collator_sort_with_sort_keys</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-extract.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-extract.xml +++ phpdoc-fr/reference/intl/functions/grapheme-extract.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-extract" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_extract</refname> <refpurpose>Extrait un groupe de graphème d'une chaîne UTF-8</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_extract</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>int</type><parameter>size</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>extract_type</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>start</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter role="reference">next</parameter></methodparam> </methodsynopsis> <para> Cette fonction extrait une séquence de groupes de graphèmes par défaut d'un texte en UTF-8. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>size</parameter></term> <listitem> <para> Le nombre maximal d'élément, en fonction de $extract_type, à retourner. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extract_type</parameter></term> <listitem> <para> Défini le type d'unités indiquées par le paramètre $size : </para> <para> <simplelist> <member>GRAPHEME_EXTR_COUNT (par défaut) : $size est le nombre de groupe de graphèmes à extraire.</member> <member>GRAPHEME_EXTR_MAXBYTES : $size est le nombre d'octets à retourner.</member> <member>GRAPHEME_EXTR_MAXCHARS : $size est le nombre de caractères UTF-8 à retourner.</member> </simplelist> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>start</parameter></term> <listitem> <para> La position de début dans $haystack, exprimée en octets. Elle doit être positive, nulle ou inférieure à la taille de $haystack en octets. La valeur par défaut est zéro. Si $start ne correspond pas au premier octets d'un caractère UTF-8 valide, la position de démarrage sera déplacée au prochain octet valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>next</parameter></term> <listitem> <para> Référence à une variable qui recevra la prochaine position de début valide. Lorsque la fonction se termine, cela peut être une position qui est au dela de la taille de la chaîne. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Une chaîne qui débute à la position $start et se termine à la limite valide d'un graphème, et qui se conformen aux conditions $size et $extract_type. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_extract</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_extract( $char_a_ring_nfd . $char_o_diaeresis_nfd, 1, GRAPHEME_EXTR_COUNT, 2)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_substr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-stripos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-stripos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-stripos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-stripos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_stripos</refname> <refpurpose>Trouve la position en graphème de la première occurrence dans une chaîne, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_stripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position en graphème de la première occurrence dans une chaîne, en effectuant une recherche insensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la position, sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_stripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_stripos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-stristr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-stristr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-stristr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-stristr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_stristr</refname> <refpurpose>Retourne la partie d'une chaîne à partir d'une occurrence</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_stristr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>before_needle</parameter></methodparam> </methodsynopsis> <para> Retourne la partie d'une chaîne à partir de la première occurrence de <parameter>needle</parameter> (insensible à la casse), et jusqu'à la fin de la chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>before_needle</parameter></term> <listitem> <para> Si &true;, <function>grapheme_stristr<function> retourne la partie de $haystack avant la première occurrence. Par défaut, ce paramètre vaut &false; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une portion de $haystack, ou &false; si $needle n'est pas trouvé. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title><function>grapheme_stristr</function> example</title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_O_diaeresis_nfd)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88a%CC%8A ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strlen.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strlen.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strlen.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strlen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strlen</refname> <refpurpose>Lit la taille d'une chaîne en nombre de graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strlen</methodname> <methodparam><type>string</type><parameter>input</parameter></methodparam> </methodsynopsis> <para> Lit la taille d'une chaîne en nombre de graphème (et non pas en octets ou caractères). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>input</parameter></term> <listitem> <para> La chaîne à mesurer. Elle doit être une chaîne UTF-8 valide. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La taille de la chaîne, et 0 si la chaîne est vide. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strlen</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 6 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strpos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strpos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strpos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strpos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strpos</refname> <refpurpose>Trouve la position du premier graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du permier graphème dans une chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strpos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strpos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strripos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strripos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strripos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strripos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strripos</refname> <refpurpose>Trouve la position du dernier graphème, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du dernier graphème, en effectuant une recherche insensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strripos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strripos</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" $char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) forme normalisée "D" print grapheme_strripos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strrpos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strrpos.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strrpos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strrpos</refname> <refpurpose>Trouve la position du dernier graphème</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_strrpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Trouve la position du dernier graphème, en effectuant une recherche sensible à la casse. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être au format UTF-8 valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le paramètre $offset permet de spécifier la position dans la $haystack de début de recherche, exprimée en graphème (et non pas en octets ou caractères). S'il est omis, la valeur par défaut est zéro. La position retournée est toujours donnée par rapport au début de $haystack, quelque soit la valeur de $offset. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l position sous forme d'entier. Si $needle n'est pas trouvé, <function>grapheme_strrpos</function> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_strrpos</function></title> <programlisting role="php"> <![CDATA[ < ?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forme normalisée "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forme normalisée "D" print grapheme_strrpos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stripos</function></member> <member><function>grapheme_stristr</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strstr</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-strstr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-strstr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-strstr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-strstr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_strstr</refname> <refpurpose>Retourne la partie d'une chaîne à partir d'une occurrence, insensible à la casse</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>string</type><methodname>grapheme_strstr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>before_needle</parameter></methodparam> </methodsynopsis> <para> Retourne la partie d'une chaîne à partir de la première occurrence de <parameter>needle</parameter> (sensible à la casse), et jusqu'à la fin de la chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> La chaîne à étudier. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> La chaîne à rechercher. Elle doit être valide UTF-8. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>before_needle</parameter></term> <listitem> <para> Si &true;, <function>grapheme_strstr<function> retourne la partie de $haystack avant la première occurrence. Par défaut, ce paramètre vaut &false; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of string, or FALSE if needle is not found. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title><function>grapheme_strstr</function> example</title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_o_diaeresis_nfd)); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ o%CC%88a%CC%8A ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_stristr</function></member> <member><function>grapheme_stripos</function></member> <member><function>grapheme_strpos</function></member> <member><function>grapheme_strripos</function></member> <member><function>grapheme_strrpos</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/grapheme-substr.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/grapheme-substr.xml +++ phpdoc-fr/reference/intl/functions/grapheme-substr.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.grapheme-substr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>grapheme_substr</refname> <refpurpose>Retourne une partie d'une chaîne</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>Procedural style</para> <methodsynopsis> <type>int</type><methodname>grapheme_substr</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam><type>int</type><parameter>start</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Retourne une partie d'une chaîne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>string</parameter></term> <listitem> <para> La chaîne à couper. Doit être UTF-8 et valide. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>start</parameter></term> <listitem> <para> La position de début, en unité par de graphèmes. Si $start est non-négatif, la chaîne retournée va commencer à la position $start dans la chaîne, en comptant à partir de 0. Si $start est négatif, la chaîne retournée va commencer à la position $start en comptant depuis la fin de la chaîne. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>length</parameter></term> <listitem> <para> La taille de la sous-chaîne à extraire, en unités de graphème. Si $length est donné et positif, la chaîne retournée va contenir au plus $length graphèmes, commençant à $start (en fonction de la taille de la chaîne). Si $string est inférieur ou égal à $start graphèmes de long, &false; sera retourné. Si $length a une valeur négative, alors autant de graphème seront omis à partir de la fin de la chaîne (après que la position de début ait été calculé, lorsque $start est aussi négatif). Si $start dénote une position au-dela de la fin de la chaîne, une chaîne vide sera retournée. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la partie de chaîne extraite de $string. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exemple avec <function>grapheme_substr</function></title> <programlisting role="php"> <![CDATA[ <?php $char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D" $char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D" print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 )); ?> ]]> </programlisting> </example> &example.outputs; <screen> <![CDATA[ a%CC%8Abco%CC%88 ]]> </screen> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>grapheme_extract</function></member> <member><function>grapheme_extractB</function></member> <member> <link xlink:href="&uri.unicode.graphemes;"> Unicode Text Segmentation: Grapheme Cluster Boundaries </link> </member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-error-name.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-error-name.xml +++ phpdoc-fr/reference/intl/functions/intl-error-name.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-error-name"> <refnamediv> <refname>intl_error_name</refname> <refpurpose>Lit le nom symbolique d'un code d'erreur donné</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type> <methodname>intl_error_name</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> Retourne le nom du code d'erreur ICU. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>error_code</parameter></term> <listitem> <para> Le code d'erreur ICU. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La chaîne retournée sera celui du nom de la constante équivalente. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_error_name</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( 'en_RU' ); $err_code = collator_get_error_code( $coll ); printf( "Le nom symbolique de %d est %s\n.", $err_code, intl_error_name( $err_code ) ); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Symbolic name for -128 is U_USING_FALLBACK_WARNING. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_is_failure</function></member> <member><function>intl_get_error_code</function></member> <member><function>intl_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-get-error-code.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-get-error-code.xml +++ phpdoc-fr/reference/intl/functions/intl-get-error-code.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-get-error-code"> <refnamediv> <refname>intl_get_error_code</refname> <refpurpose>Lit le dernier code d'erreur</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type> <methodname>intl_get_error_code</methodname> <void /> </methodsynopsis> <para> Pratique pour gérer les erreurs qui surviennent dans les méthodes statiques quand il n'y a pas d'objet dont on peut obtenir le message d'erreur. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Le code d'erreur retourné par le dernier appel à l'API. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_get_error_code</function></title> <programlisting role="php"> <![CDATA[ <?php $coll = collator_create( '<bad_param>' ); if( !$coll ) { handle_error( intl_get_error_code() ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_is_failure</function></member> <member><function>intl_error_name</function></member> <member><function>intl_get_error_message</function></member> <member><function>collator_get_error_code</function></member> <member><function>numfmt_get_error_code</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-get-error-message.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-get-error-message.xml +++ phpdoc-fr/reference/intl/functions/intl-get-error-message.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-get-error-message"> <refnamediv> <refname>intl_get_error_message</refname> <refpurpose>Lit la description de la dernière erreur</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type> <methodname>intl_get_error_message</methodname> <void /> </methodsynopsis> <para> Lit le message d'erreur de la dernière fonction d'internationalisation appelée. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La description de l'erreur qui est survenue durant le dernier appel de l'API. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_get_error_message</function></title> <programlisting role="php"> <![CDATA[ <?php if( Collator::getAvailableLocales() === false ) { show_error( intl_get_error_message() ); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_error_name</function></member> <member><function>intl_get_error_code</function></member> <member><function>intl_is_failure</function></member> <member><function>collator_get_error_message</function></member> <member><function>numfmt_get_error_message</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/intl/functions/intl-is-failure.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/intl/functions/intl-is-failure.xml +++ phpdoc-fr/reference/intl/functions/intl-is-failure.xml <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.intl-is-failure"> <refnamediv> <refname>intl_is_failure</refname> <refpurpose>Vérifie si un code d'erreur indique un échec</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type> <methodname>intl_is_failure</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> <!-- description goes here --> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>error_code</parameter></term> <listitem> <para> une valeur retournée par une des fonctions <function>intl_get_error_code</function>, <function>collator_get_error_code</function> . </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le code indique un échec, et &false; dans le cas d'une réussite ou d'une alerte. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>intl_is_failure</function></title> <programlisting role="php"> <![CDATA[ <?php function check( $err_code ) { var_export( intl_is_failure( $err_code ) ); echo "\n"; } check( U_ZERO_ERROR ); check( U_USING_FALLBACK_WARNING ); check( U_ILLEGAL_ARGUMENT_ERROR ); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ false false true ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>intl_get_error_code</function></member> <member><function>collator_get_error_code</function></member> <member><function>Collator-getErrorCode</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 -->