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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: jpauli Status: ready -->
<!-- Reviewed: yes -->

<section xml:id="intl.collator-constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 <para>
  <variablelist>
   <varlistentry xml:id="collator.constants.french-collation">
    <term>
     <constant>Collator::FRENCH_COLLATION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      Trie les chaînes avec différents accents, sur la fin de la chaîne.
      Cet attribut est automatiquement configuré à <emphasis>On</emphasis>
      pour les locales françaises, et quelques autres. Les utilisateurs n'ont
      pas besoin de configurer explicitement cet attribut. Il y a un
      coût de performances lors de la comparaison des chaînes quand
      cet attribut est à <emphasis>On</emphasis>, mais la taille des
      clés de tris est inchangée. Les valeurs possibles sont :
      <simplelist>
       <member><constant>Collator::ON</constant></member>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
     <para>
      <example>
       <title>Règles de FRENCH_COLLATION</title>
       <para>
        <simplelist>
         <member>F=OFF cote &lt; coté &lt; côte &lt; côté </member>
         <member>F=ON cote &lt; côte &lt; coté &lt; côté</member>
        </simplelist>
       </para>
      </example>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.alternate-handling">
    <term>
     <constant>Collator::ALTERNATE_HANDLING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      L'attribut alterné est utilisé pour contrôler la gestion des caractères
      variables de UCA : les espaces blancs, la ponctuation et les symboles.
      Si Alternate est configuré à <emphasis>NonIgnorable</emphasis>
      (N), alors les différences entre ces caractères sont de la même 
      importance que les différences entre les lettres. Si Alternate
      est configuré à <emphasis>Shifted</emphasis> (S), alors ces caractères
      seront d'importance mineur. La valeur <emphasis>Shifted</emphasis> 
      est souvent utilisée conjointement avec Quaternary qui vaut
      <emphasis>Strength</emphasis>. Dans ce cas, les espaces blancs, la ponctuation
      et les symboles sont considérés lors de la comparaison, mais uniquement 
      si les autres aspects de la chaînes (lettres de base, accents et casse)
      sont tous identiques. Si Alternate n'est pas configuré à Shifted, il n'y a
      alors pas de différence entre une Strength de 3 et une Strength de 4. 
      Pour plus d'information et d'exemples, voyez Variable_Weighting dans 
      <link xlink:href="&url.icu.uca;">UCA</link>. La raison qui fait que les 
      valeurs de Alternate ne sont pas seulement <emphasis>On</emphasis> et
      <emphasis>Off</emphasis> est que des valeurs supplémentaires pour 
      Alternate pourraient être ajoutées à l'avenir. L'option UCA
      Blanked est exprimée avec une valeur de Strength à 3, et Alternate configuré à
      Shifted. La valeur par défaut pour la majorité des locales est 
      NonIgnorable. Si Shifted est sélectionné, il peut être plus lent s'il y a 
      de nombreuses chaînes qui sont identiques, sauf pour la ponctuation : la taille
      de la clé de tri sera inchangée, à mois que le niveau de Strength ne soit élevé.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::NON_IGNORABLE</constant>(par défaut)</member>
       <member><constant>Collator::SHIFTED</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
     <para>
      <example>
       <title>Règles ALTERNATE_HANDLING</title>
       <para>
        <simplelist>
         <member>
          S=3, A=N di Silva &lt; Di Silva &lt; diSilva &lt; U.S.A. &lt; USA
         </member> 
         <member>
          S=3, A=S di Silva = diSilva &lt; Di Silva &lt; U.S.A. = USA
         </member> 
         <member>
          S=4, A=S di Silva &lt; diSilva &lt; Di Silva &lt; U.S.A. &lt; USA
         </member>
        </simplelist>
       </para>
      </example>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.case-first">
    <term>
     <constant>Collator::CASE_FIRST</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      L'attribut Case_First est utilisé pour contrôler le fait que les majuscules
      doivent être considérées comme avant les minuscules, et vice-versa, en 
      l'absence d'autres discriminant. Les valeurs possibles sont 
      <emphasis>Uppercase_First</emphasis>
      (U) et <emphasis>Lowercase_First</emphasis>
      (L), plus les valeurs standards <emphasis>Default</emphasis>
      et <emphasis>Off</emphasis>.
      Il n'y a presque pas de différence entre Off et Lowercase_First
      en termes de résultats, ce qui fait que les utilisateurs typiques
      n'utiliseront pas Lowercase_First : uniquement Off ou Uppercase_First. 
      (ceux qui sont intéressés par les différences entre X et L devront
      consulter la section <literal>Collation Customization</literal>). 
      Spécifier L ou U ne va pas changer les performances de comparaison,
      mais va affecter la taille de la clé de tri.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::LOWER_FIRST</constant></member>
       <member><constant>Collator::UPPER_FIRST</constant></member>
       <member><constant>Collator:DEFAULT</constant></member>
      </simplelist>
     </para>
     <para>
      <example>
       <title>Règles CASE_FIRST</title>
       <para>
        <simplelist>
         <member>C=X or C=L "china" &lt; "China" &lt; "denmark" &lt; "Denmark"</member> 
         <member>C=U "China" &lt; "china" &lt; "Denmark" &lt; "denmark"</member>
        </simplelist>
       </para>
      </example>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.case-level">
    <term>
     <constant>Collator::CASE_LEVEL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      L'attribut Case_Level est utilisé pour ignorer les accents, mais pas la casse.
      Dans ces situations, mettez l'attribut Strength à <emphasis>Primary</emphasis>,
      et Case_Level à <emphasis>On</emphasis>. Dans la plupart des locales, cet
      attribut est à Off par défaut. Il y a un petit coût de performances
      pour la comparaison des chaînes, un un impact sur la taille des index de tri
      si cet attribut est à <emphasis>On</emphasis>.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::ON</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
     <para>
      <example>
       <title>Règles CASE_LEVEL</title>
       <para>
        <simplelist>
         <member>S=1, E=X role = Role = rôle</member> 
         <member>S=1, E=O role = rôle &lt; Role</member>
        </simplelist>
       </para>
      </example>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.normalization-mode">
    <term>
     <constant>Collator::NORMALIZATION_MODE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      L'attribut Normalization détermine s'il faut normaliser totalement
      le texte ou non, pour la comparaison. Même si cet attribut à Off (ce qui
      set le cas par défaut pour de nombreuses locales), les textes comparés
      pour un usage ordinaire seront corrects (pour des détails, voyez UTN #5).
      Il n'y aura un problème que si les marques d'accent ne sont pas canoniques.
      Si cet attribut est à <emphasis>On</emphasis>, alors les meilleurs résultats
      sont garantis pour tous les textes. Il y a un coût de comparaison
      moyen si cet attribut vaut <emphasis>On</emphasis>, en fonction de la fréquence des
      séquences qui requièrent de la normalisation. Il n'y a pas d'effet
      significatif sur la taille des index de tri. Si le texte est réputé
      dans les formes de normalisation NFD ou NFKD, il n'y a pas besoin d'activer
      l'option de Normalization.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::ON</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.strength">
    <term>
     <constant>Collator::STRENGTH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      Le service de collation ICU supporte de nombreux niveaux de comparaison
      (appelés "Levels", mais aussi connus sous le nom de "Strengths"). 
      Avec ces catégories, ICU peut trier les chaînes avec précision, en
      fonction des conventions locales. Cependant, en permettant l'utilisation
      sélective 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>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::PRIMARY</constant></member>
       <member><constant>Collator::SECONDARY</constant></member>
       <member><constant>Collator::TERTIARY</constant>(par défaut)</member>
       <member><constant>Collator::QUATERNARY</constant></member>
       <member><constant>Collator::IDENTICAL</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.hiragana-quaternary-mode">
    <term>
     <constant>Collator::HIRAGANA_QUATERNARY_MODE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      La compatibilité avec JIS x 4061 requiert l'introduction d'un niveau
      supplémentaire pour distinguer les caractères Hiragana et Katakana. 
      Si la compatibilité avec le standard est nécessaire, alors cet attribut
      doit être utilisé à <emphasis>On</emphasis>, et la Strength doit prendre
      la valeur de Quaternary. Cela va affecter la taille des index de tri,
      et les performances de comparaisons des chaînes.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::ON</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.numeric-collation">
    <term>
     <constant>Collator::NUMERIC_COLLATION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <para>
      Lorsqu'activé, cet attribut génère une clé de collation pour les valeurs
      numériques de sous-chaînes. C'est une méthode pour que '100' soit trié
      après '2'.
     </para>
     <para>
      Les valeurs possibles sont : 
      <simplelist>
       <member><constant>Collator::OFF</constant>(par défaut)</member>
       <member><constant>Collator::ON</constant></member>
       <member><constant>Collator::DEFAULT_VALUE</constant></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.default-value">
    <term>
     <constant>Collator::DEFAULT_VALUE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.primary">
    <term>
     <constant>Collator::PRIMARY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.secondary">
    <term>
     <constant>Collator::SECONDARY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.tertiary">
    <term>
     <constant>Collator::TERTIARY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.default-strength">
    <term>
     <constant>Collator::DEFAULT_STRENGTH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.quaternary">
    <term>
     <constant>Collator::QUATERNARY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.identical">
    <term>
     <constant>Collator::IDENTICAL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.off">
    <term>
     <constant>Collator::OFF</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.on">
    <term>
     <constant>Collator::ON</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.shifted">
    <term>
     <constant>Collator::SHIFTED</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.non-ignorable">
    <term>
     <constant>Collator::NON_IGNORABLE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.lower-first">
    <term>
     <constant>Collator::LOWER_FIRST</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="collator.constants.upper-first">
    <term>
     <constant>Collator::UPPER_FIRST</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</section>

<!-- 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
-->