<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.collator.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'collator.setstrength.php',
    1 => 'Collator::setStrength',
    2 => 'D&eacute;finit la force de collation',
  ),
  'up' => 
  array (
    0 => 'class.collator.php',
    1 => 'Collator',
  ),
  'prev' => 
  array (
    0 => 'collator.setattribute.php',
    1 => 'Collator::setAttribute',
  ),
  'next' => 
  array (
    0 => 'collator.sort.php',
    1 => 'Collator::sort',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/intl/collator/set-strength.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="collator.setstrength" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Collator::setStrength</h1>
  <h1 class="refname">collator_set_strength</h1>
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8, PECL intl &gt;= 1.0.0)</p><p class="refpurpose"><span class="refname">Collator::setStrength</span> -- <span class="refname">collator_set_strength</span> &mdash; <span class="dc-title">Définit la force de collation</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-collator.setstrength-description">
  <h3 class="title">Description</h3>
  <p class="para">
   Style orienté objet
  </p>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Collator::setStrength</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$strength</code></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>

  <p class="para rdfs-comment">
   Style procédural
  </p>
  <div class="methodsynopsis dc-description"><span class="methodname"><strong>collator_set_strength</strong></span>(<span class="methodparam"><span class="type"><a href="class.collator.php" class="type Collator">Collator</a></span> <code class="parameter">$object</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$strength</code></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>

  <p class="para rdfs-comment">
   Le service de collation <a href="https://icu.unicode.org/" class="link external">&raquo;&nbsp;ICU</a>
   supporte de nombreux niveaux de comparaison (appelés &quot;Levels&quot;, mais aussi
   connus sous le nom de &quot;Strengths&quot;). Avec ces catégories, ICU peut trier les
   chaînes avec précision, en fonction des conventions locales. Cependant, en
   permettant l&#039;utilisation sélective des niveaux, la recherche d&#039;une chaîne
   dans un texte peut être réalisée, à partir de différentes conditions. Pour
   plus d&#039;informations, voir le chapitre <span class="function"><strong>collator_set_strength()</strong></span>.
  </p>
  <p class="para">
   <ol type="1">
    <li class="listitem">
     <p class="para"> 
      <em>Niveau primaire</em> :
      Typiquement, ceci est utilisé pour faire la différence entre des
      caractères de bases, comme &quot;a&quot; &lt; &quot;b&quot;). C&#039;est la différence la plus
      importante. Par exemple, les dictionnaires sont divisés en sections
      avec les caractères de base.
      Ceci est aussi appelé le <code class="literal">level 1</code> de force.
     </p>
    </li>
    <li class="listitem">
     <p class="para"> 
      <em>Niveau secondaire</em> :
      Les accents sur les caractères sont considérés comme des différences
      secondaires. Par exemple, &quot;as&quot; &lt; &quot;às&quot; &lt; &quot;at&quot;. D&#039;autres différences
      entre les caractères peuvent être considérées comme secondaires, en fonction
      des langues. Une différence secondaire est toujours ignorée quand
      une différence primaire est présente.
      Ceci est aussi appelé le <code class="literal">level 2</code> de force.
      <blockquote class="note"><p><strong class="note">Note</strong>: 
       <p class="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 simples de la lettre.
       </p>
      </p></blockquote>
     </p>
    </li>
    <li class="listitem">
     <p class="para"> 
      <em>Niveau tertiaire</em> :
      les majuscules et les minuscules sont distinguées au niveau tertiaire. 
      par exemple, &quot;ao&quot; &lt; &quot;Ao&quot; &lt; &quot;aò&quot;. De plus, une variante d&#039;une lettre
      est différente de la forme de base, au niveau ternaire. Par exemple, 
      &quot;a&quot; et &quot;𝒶&quot;. Un autre exemple de différence 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.
      Ceci est aussi appelé le <code class="literal">level 3</code> de force.
     </p>
    </li>
    <li class="listitem">
     <p class="para"> 
      <em>Niveau quaternaire</em> :
      Lorsque la ponctuation est ignorée, aux niveaux 1-3, un niveau supplémentaire
      peut être utilisé pour distinguer des mots avec ou sans ponctuation. Par exemple,
      &quot;ab&quot; &lt; &quot;a-b&quot; &lt; &quot;aB&quot;. Cette différence est ignorée lorsqu&#039;il y a une
      différence de niveau primaire, secondaire ou tertiaire.
      Ceci est aussi appelé le <code class="literal">level 4</code> de force.
      Le niveau quaternaire ne doit être utilisé que lorsqu&#039;il faut ignorer la
      ponctuation ou traiter du texte japonais (traitement Hiragana).
     </p>
    </li>
    <li class="listitem">
     <p class="para"> 
      <em>Niveau identique</em> :
      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&#039;y aurait
      pas de différence aux niveaux 1-4. Par exemple, les cantillations hébraïques
      ne sont distinguées qu&#039;à ce niveau. Ce niveau ne doit être utilisé
      qu&#039;avec beaucoup de parcimonie, car il fait substantiellement décroître
      les performances.
      Ceci est aussi appelé le <code class="literal">level 5</code> de force.
     </p>
    </li>
   </ol>
  </p>
  <p class="para">
   Par exemple, on peut choisir d&#039;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&#039;arrêtent au niveau trois.
   Cependant, si l&#039;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érences très subtiles
   sont nécessaires entre les caractères, le niveau identique peut être utilisé
   (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.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-collator.setstrength-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">object</code></dt>
     <dd>
      <p class="para">
       Objet <span class="classname"><a href="class.collator.php" class="classname">Collator</a></span>.
      </p>
     </dd>
    
    
     <dt><code class="parameter">strength</code></dt>
     <dd>
      <p class="para">Le niveau à choisir.</p>
      <p class="para">
       Les valeurs possibles sont : 
       <ul class="itemizedlist">
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.primary">Collator::PRIMARY</a></code></strong>
         </p>
        </li>
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.secondary">Collator::SECONDARY</a></code></strong>
         </p>
        </li>
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.tertiary">Collator::TERTIARY</a></code></strong>
         </p>
        </li>
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.quaternary">Collator::QUATERNARY</a></code></strong>
         </p>
        </li>
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.identical">Collator::IDENTICAL</a></code></strong>
         </p>
        </li>
        <li class="listitem">
         <p class="para">
          <strong><code><a href="class.collator.php#collator.constants.default-strength">Collator::DEFAULT_STRENGTH</a></code></strong>
         </p>
        </li>
       </ul>
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-collator.setstrength-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   Retourne toujours <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-collator.setstrength-examples">
  <h3 class="title">Exemples</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Exemple avec <span class="function"><strong>collator_set_strength()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$arr  </span><span style="color: #007700">= array( </span><span style="color: #DD0000">'aò'</span><span style="color: #007700">, </span><span style="color: #DD0000">'Ao'</span><span style="color: #007700">, </span><span style="color: #DD0000">'ao' </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$coll </span><span style="color: #007700">= </span><span style="color: #0000BB">collator_create</span><span style="color: #007700">( </span><span style="color: #DD0000">'en_US' </span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// Trie un tableau avec le niveau par défaut<br /></span><span style="color: #0000BB">collator_sort</span><span style="color: #007700">( </span><span style="color: #0000BB">$coll</span><span style="color: #007700">, </span><span style="color: #0000BB">$arr </span><span style="color: #007700">); <br /></span><span style="color: #0000BB">var_export</span><span style="color: #007700">( </span><span style="color: #0000BB">$arr </span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// Tri un tableau avec le niveau primaire<br /></span><span style="color: #0000BB">collator_set_strength</span><span style="color: #007700">( </span><span style="color: #0000BB">$coll</span><span style="color: #007700">, </span><span style="color: #0000BB">Collator</span><span style="color: #007700">::</span><span style="color: #0000BB">PRIMARY </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">collator_sort</span><span style="color: #007700">( </span><span style="color: #0000BB">$coll</span><span style="color: #007700">, </span><span style="color: #0000BB">$arr </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_export</span><span style="color: #007700">( </span><span style="color: #0000BB">$arr </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>L&#039;exemple ci-dessus va afficher :</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">array (
  0 =&gt; &#039;ao&#039;,
  1 =&gt; &#039;Ao&#039;,
  2 =&gt; &#039;aò&#039;,
)
array (
  0 =&gt; &#039;aò&#039;,
  1 =&gt; &#039;Ao&#039;,
  2 =&gt; &#039;ao&#039;,
)</pre>
</div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-collator.setstrength-seealso">
  <h3 class="title">Voir aussi</h3>
  <p class="para">
   <ul class="simplelist">
    <li>Constantes <a href="class.collator.php#intl.collator-constants" class="link"><span class="classname"><a href="class.collator.php" class="classname">Collator</a></span></a></li>
    <li><span class="function"><a href="collator.getstrength.php" class="function" rel="rdfs-seeAlso">collator_get_strength()</a> - R&eacute;cup&egrave;re la duret&eacute; de classement utilis&eacute;</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>