<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'collator.setstrength.php',
    1 => 'Collator::setStrength',
    2 => 'Define a for&ccedil;a do agrupador',
  ),
  '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' => 'pt_BR',
    '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">Define a força do agrupador</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-collator.setstrength-description">
  <h3 class="title">Descrição</h3>
  <p class="para">
   Estilo orientado a objetos
  </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">
   Estilo procedural
  </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">
   O Serviço de Agrupamento
   <a href="https://icu.unicode.org/" class="link external">&raquo;&nbsp;ICU</a>
   suporta vários níveis de comparação, também chamados
   de &quot;forças&quot; (&quot;strengths&quot;). Estas categorias permitem à ICU ordenar
   strings com precisão conforme convenções locais. Entretanto, ao permitir que
   os níveis sejam seletivamente empregados, a pesquisa por uma string em um texto pode
   ser realizada com várias condições de correspondência.
  </p>
  <p class="para">
   <ol type="1">
    <li class="listitem">
     <p class="para">
      <em>Nível primário</em>:
      Tipicamento usado para indicar diferenças entre caracteres base
      (por exemplo &quot;a&quot; &lt; &quot;b&quot;). É a diferença mais forte. Por
      exemplo, dicionários são divididos em seções por caractere
      base. É também chamado de força nível 1 (<code class="literal">level 1</code>).
     </p>
    </li>
    <li class="listitem">
     <p class="para">
      <em>Nível secundário</em>:
      Acentuações nos caracteres são consideradas diferenças secundárias (por
      exemplo, &quot;as&quot; &lt; &quot;às&quot; &lt; &quot;at&quot;). Outras diferenças entre letras podem
      também ser consideradas secundárias, dependendo da língua.
      Uma diferença secundária é ignorada quando existir uma diferença primária
      em qualquer lugar nas strings. Também chamado de força nível 2 (<code class="literal">level 2</code>).
      <blockquote class="note"><p><strong class="note">Nota</strong>: 
       <p class="para">
        Nota: Em algumas línguas (como o dinamarquês), certas letras acentuadas são
        consideradas como caracteres base separados. Na maioria da línguas, entretanto,
        uma letra com acentuação tem apenas diferença secundária em relação
        à versão não acentuada dessa letra.
       </p>
      </p></blockquote>
     </p>
    </li>
    <li class="listitem">
     <p class="para">
      <em>Nível terciário</em>:
      Diferenças de maiúsculas e minúsculas são distinguidas no
      nível terciário (por exemplo, &quot;ao&quot; &lt; &quot;Ao&quot; &lt; &quot;aò&quot;). Além disso,
      uma variante de uma letra se diferencia da forma base no nível terciário
      (como &quot;a&quot; e &quot;𝒶&quot;). Outro exemplo é a diferença entre o Kana grande e o
      pequeno. Uma diferença terciária é ignorada quando existir uma diferença primária
      ou secundária em qualquer lugar nas strings. Também chamado de força
      nível 3 (<code class="literal">level 3</code>).
     </p>
    </li>
    <li class="listitem">
     <p class="para">
      <em>Nível quaternário</em>:
      Quando a pontuação é ignorada (consulte Ignorando Pontuaçõs) em níveis 1-3,
      um nível adicional pode ser usado para distinguir palavras com e sem
      pontuação (por exemplo, &quot;ab&quot; &lt; &quot;a-b&quot; &lt; &quot;aB&quot;). Esta diferença é
      ignorada quando há uma diferença primária, secundária ou terciária. Também
      conhecida como força nível 4 (<code class="literal">level 4</code>). O nível quaternário deve
      ser usado apenas se for requerido ignorar a pontuação ou ao processar texto
      em japonês (consulte processamento de Hiragana).
     </p>
    </li>
    <li class="listitem">
     <p class="para">
      <em>Nível idêntico</em>:
      Quando todos os outros níveis são iguais, o nível idêntico é usado como um
      desempate. Os valores de ponto de código Unicode para a forma NFD de cada string
      são comparados neste nível, apenas caso não haja nenhuma diferença nos
      níveis 1 a 4. Por exemplo, os sinais hebraicos de cantilação somente são distinguidos
      neste nível. Este nível deve ser usado com moderação, já que diferenças somente de valores
      de ponto de código entre duas strings é uma ocorrência extremamente rara.
      Usar este nível diminui consideravelmente o desempenho tanto para
      comparação incremental quanto para geração de chave de ordenação (e também aumenta
      o comprimento da chave). Também conhecido como força nível 5 (<code class="literal">level 5</code>).
     </p>
    </li>
   </ol>
  </p>
  <p class="para">
   Por exemplo, pode-se decidir por ignorar acentuação ou ignorar tanto acentuação quanto
   maiúsculas e minúsculas ao pesquisar por texto. Quase todos os caracteres são diferenciáveis
   pelos primeiros três níveis e por isso, na maior parte das localidades, o valor padrão é o terciário.
   Entratanto, se a opção ALTERNATE for definida para SHIFTED, a força quaternária
   pode ser usada para desempatar entre espaços em branco, pontuação e símbolos que
   em outros casos seriam ignorados. Se uma distinção muito fina entre caracteres for
   necessária, o nível idêntico pode ser usado (por exemplo, o nível idêntico
   distingue entre a letra &quot;a&quot; minúscula matemática em negrito e a
   letra &quot;a&quot; minúscula matemática em itálico). Entretanto, usar níveis mais altos que o terciário
   resulta em chaves de ordenação significativamente mais longas, e desempenho
   mais lento de comparação para strings iguais.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-collator.setstrength-parameters">
  <h3 class="title">Parâmetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">object</code></dt>
     <dd>
      <p class="para">
       Objeto <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">Força a ser definida.</p>
      <p class="para">
       Valores possíveis são:
       <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">Valor Retornado</h3>
  <p class="para">
   Sempre retorna <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">Exemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemplo #1 Exemplo de <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">// Ordena o array usando a força padrão.<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">// Ordena o array usando a força primária.<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>O exemplo acima produzirá:</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">Veja Também</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="class.collator.php#intl.collator-constants" class="link">Constantes de <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> - Obt&eacute;m a for&ccedil;a atual de agrupamento</span></li>
   </ul>
  </p>
 </div>

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