doc-fr/reference/intl/collator/construct.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: da9e1ca20838bdc83aa6809160ef014ebde28837 Maintainer: yannick 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éation d'un collator</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <constructorsynopsis>
   <modifier>public</modifier> <methodname>Collator::__construct</methodname>
   <methodparam><type>string</type><parameter>locale</parameter></methodparam>
  </constructorsynopsis>
  <para>
   Création d'une nouvelle instance de <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 une &string; vide est passé, la locale par défaut sera utilisée.
       Si le mot clé <literal>"root"</literal> est passé, les règles
       <link xlink:href="&url.icu.uca;">UCA</link> 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,
        &lt;language&gt;_&lt;script&gt;_&lt;region&gt;_&lt;keyword&gt;
        is represented by:
        L&lt;language&gt;_Z&lt;script&gt;_R&lt;region&gt;_V&lt;variant&gt;_K&lt;keyword&gt;.
        for <emphasis>RFC4646</emphasis> locale naming.
        
        <example><title>Locale format</title>
        Example:
        Locale="sv" (Swedish) "Kypper" &lt; "Köpfe"
        Locale="de" (German) "Köpfe" &lt; "Kypper"
        </example>
       -->
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Retourne un objet "vide" en cas d'erreur.
   Utiliser <function>intl_get_error_code</function> et / ou
   <function>intl_get_error_message</function> pour en savoir plus.
  </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:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->