<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.operators.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'language.operators.precedence.php',
    1 => 'Preced&ecirc;ncia de Operadores',
    2 => 'Preced&ecirc;ncia de Operadores',
  ),
  'up' => 
  array (
    0 => 'language.operators.php',
    1 => 'Operadores',
  ),
  'prev' => 
  array (
    0 => 'language.operators.php',
    1 => 'Operadores',
  ),
  'next' => 
  array (
    0 => 'language.operators.arithmetic.php',
    1 => 'Aritm&eacute;ticos',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'language/operators/precedence.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.operators.precedence" class="sect1">
 <h2 class="title">Precedência de Operadores</h2>
 
 <p class="para">
  A precedência de um operador especifica quem tem mais prioridade quando há
  duas delas juntas. Por exemplo, na expressão <code class="literal">1 +
  5 * 3</code>, a resposta é <code class="literal">16</code> e não
  <code class="literal">18</code> porque o operador de multiplicação (&quot;*&quot;)
  tem prioridade de precedência que o operador de adição (&quot;+&quot;).
  Parênteses podem ser utilizados para forçar a precedência, se necessário.
  Assim, <code class="literal">(1 + 5) * 3</code> é avaliado como
  <code class="literal">18</code>.
 </p>
 <p class="para">
  Quando operadores têm precedência igual a associatividade decide
  como os operadores são agrupados. Por exemplo &quot;-&quot; é associado à esquerda, de forma que
  <code class="literal">1 - 2 - 3</code> é agrupado como <code class="literal">(1 - 2) - 3</code>
  e resulta em <code class="literal">-4</code>. &quot;=&quot; por outro lado
  associa para a direita, de forma que <code class="literal">$a = $b = $c</code> é agrupado como
  <code class="literal">$a = ($b = $c)</code>.
 </p>
 <p class="para">
  Operadores de igual precedência e associatividade não podem
  ser utilizados uns próximos aos outros. Por exemplo <code class="literal">1 &lt; 2 &gt; 1</code> é
  ilegal no PHP. A expressão <code class="literal">1 &lt;= 1 == 1</code> por outro
  lado é válida, porque o operador <code class="literal">==</code> tem menor
  precedência que o operador <code class="literal">&lt;=</code>.
 </p>
 <p class="para">
  A associatividade somente faz sentido para operadores binários e ternários.
  Operadores unários são precedentes ou seguintes, de forma que essa outra noção não se aplica.
  Por exemplo <code class="literal">!!$a</code> somente pode ser agrupado como <code class="literal">!(!$a)</code>.
 </p>
 <p class="para">
  O uso de parênteses, embora não estritamente necessário, pode melhorar
  a leitura do código ao deixar o agrupamento explícito em vez de depender
  da associatividade e precedências implícitos.
 </p>
 <p class="para">
  A tabela seguinte mostra a precedência dos operadores, com a maior
  precedência no começo. Operadores com a mesma precedência estão na mesma linha,
  nesses casos a associatividade deles decidirá qual ordem eles serão avaliados.
  <table class="doctable table">
   <caption><strong>Precedência dos operadores</strong></caption>
   
    <thead>
     <tr>
      <th>Associação</th>
      <th>Operadores</th>
      <th>Informação Adicional</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>(não aplicável)</td>
      <td>
       <code class="literal">clone</code>
       <code class="literal">new</code>
      </td>
      <td><a href="language.oop5.cloning.php" class="link">clone</a> e <a href="language.oop5.basic.php#language.oop5.basic.new" class="link">new</a></td>
     </tr>

     <tr>
      <td>direita</td>
      <td><code class="literal">**</code></td>
      <td><a href="language.operators.arithmetic.php" class="link">aritmética</a></td>
     </tr>

     <tr>
      <td>(não aplicável)</td>
      <td>
       <code class="literal">+</code>
       <code class="literal">-</code>
       <code class="literal">++</code>
       <code class="literal">--</code>
       <code class="literal">~</code>
       <code class="literal">(int)</code>
       <code class="literal">(float)</code>
       <code class="literal">(string)</code>
       <code class="literal">(array)</code>
       <code class="literal">(object)</code>
       <code class="literal">(bool)</code>
       <code class="literal">@</code>
      </td>
      <td>
       <a href="language.operators.arithmetic.php" class="link">aritméticos</a> (unário <code class="literal">+</code> e <code class="literal">-</code>),
       <a href="language.operators.increment.php" class="link">incremento/decremento</a>,
       <a href="language.operators.bitwise.php" class="link">bitwise</a>,
       <a href="language.types.type-juggling.php#language.types.typecasting" class="link">type cast</a> e
       <a href="language.operators.errorcontrol.php" class="link">controle de erro</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">instanceof</code></td>
      <td>
       <a href="language.operators.type.php" class="link">tipos</a>
      </td>
     </tr>

     <tr>
      <td>(não aplicável)</td>
      <td><code class="literal">!</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td>
       <code class="literal">*</code>
       <code class="literal">/</code>
       <code class="literal">%</code>
      </td>
      <td>
       <a href="language.operators.arithmetic.php" class="link">aritmética</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td>
       <code class="literal">+</code>
       <code class="literal">-</code>
       <code class="literal">.</code>
      </td>
      <td>
       <a href="language.operators.arithmetic.php" class="link">aritmética</a> (binário <code class="literal">+</code> e <code class="literal">-</code>),
       <a href="language.operators.array.php" class="link">array</a> e
       <a href="language.operators.string.php" class="link">string</a> (<code class="literal">.</code> anteriormente ao PHP 8.0.0)
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td>
       <code class="literal">&lt;&lt;</code>
       <code class="literal">&gt;&gt;</code>
      </td>
      <td>
       <a href="language.operators.bitwise.php" class="link">bits</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">.</code></td>
      <td>
       <a href="language.operators.string.php" class="link">string</a> (a partir do PHP 8.0.0)
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">|&gt;</code></td>
      <td>
       <a href="language.operators.functional.php" class="link">pipe</a>
      </td>
     </tr>

     <tr>
      <td>não associativo</td>
      <td>
       <code class="literal">&lt;</code>
       <code class="literal">&lt;=</code>
       <code class="literal">&gt;</code>
       <code class="literal">&gt;=</code>
      </td>
      <td>
       <a href="language.operators.comparison.php" class="link">comparação</a>
      </td>
     </tr>

     <tr>
      <td>não associativo</td>
      <td>
       <code class="literal">==</code>
       <code class="literal">!=</code>
       <code class="literal">===</code>
       <code class="literal">!==</code>
       <code class="literal">&lt;&gt;</code>
       <code class="literal">&lt;=&gt;</code>
      </td>
      <td>
       <a href="language.operators.comparison.php" class="link">comparação</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">&amp;</code></td>
      <td>
       <a href="language.operators.bitwise.php" class="link">bits</a> e
       <a href="language.references.php" class="link">referências</a></td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">^</code></td>
      <td>
       <a href="language.operators.bitwise.php" class="link">bits</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">|</code></td>
      <td>
       <a href="language.operators.bitwise.php" class="link">bits</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">&amp;&amp;</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">||</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>direita</td>
      <td><code class="literal">??</code></td>
      <td>
       <a href="language.operators.comparison.php#language.operators.comparison.coalesce" class="link">null coalescing</a>
      </td>
     </tr>

     <tr>
      <td>não associativo</td>
      <td><code class="literal">? :</code></td>
      <td>
       <a href="language.operators.comparison.php#language.operators.comparison.ternary" class="link">ternário</a>
       (esquerda anteriormente ao PHP 8.0.0)
      </td>
     </tr>

     <tr>
      <td>direita</td>
      <td>
       <code class="literal">=</code>
       <code class="literal">+=</code>
       <code class="literal">-=</code>
       <code class="literal">*=</code>
       <code class="literal">**=</code>
       <code class="literal">/=</code>
       <code class="literal">.=</code>
       <code class="literal">%=</code>
       <code class="literal">&amp;=</code>
       <code class="literal">|=</code>
       <code class="literal">^=</code>
       <code class="literal">&lt;&lt;=</code>
       <code class="literal">&gt;&gt;=</code>
       <code class="literal">??=</code>
      </td>
      <td>
       <a href="language.operators.assignment.php" class="link">atribuição</a>
      </td>
     </tr>

     <tr>
      <td>(não aplicável)</td>
      <td><code class="literal">yield from</code></td>
      <td>
       <a href="language.generators.syntax.php#control-structures.yield.from" class="link">yield from</a>
      </td>
     </tr>

     <tr>
      <td>(não aplicável)</td>
      <td><code class="literal">yield</code></td>
      <td>
       <a href="language.generators.syntax.php#control-structures.yield" class="link">yield</a>
      </td>
     </tr>

     <tr>
      <td>(não aplicável)</td>
      <td><code class="literal">print</code></td>
      <td><span class="function"><a href="function.print.php" class="function">print</a></span></td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">and</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">xor</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>esquerda</td>
      <td><code class="literal">or</code></td>
      <td>
       <a href="language.operators.logical.php" class="link">lógicos</a>
      </td>
     </tr>

     <tr>
      <td>(n/a)</td>
      <td><code class="literal">throw</code></td>
      <td>
       <a href="language.exceptions.php" class="link">throw</a>
      </td>
     </tr>

    </tbody>
   
  </table>

 </p>
 <p class="para">
  <div class="example" id="example-1">
   <p><strong>Exemplo #1 Associação</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">3 </span><span style="color: #007700">* </span><span style="color: #0000BB">3 </span><span style="color: #007700">% </span><span style="color: #0000BB">5</span><span style="color: #007700">; </span><span style="color: #FF8000">// (3 * 3) % 5 = 4<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">$b </span><span style="color: #007700">+= </span><span style="color: #0000BB">3</span><span style="color: #007700">; </span><span style="color: #FF8000">// $a = ($b += 3) -&gt; $a = 5, $b = 5<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  O operador ternário requer especificamente o uso de parênteses para
  remover a ambiguidade de precedência.
 </p>
 <p class="para">
  <div class="example" id="example-2">
   <p><strong>Exemplo #2 Precedência explícita</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">true </span><span style="color: #007700">? </span><span style="color: #0000BB">0 </span><span style="color: #007700">: (</span><span style="color: #0000BB">true </span><span style="color: #007700">? </span><span style="color: #0000BB">1 </span><span style="color: #007700">: </span><span style="color: #0000BB">2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// isto não é permitido desde o PHP 8<br />// $a = true ? 0 : true ? 1 : 2;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  A precedência e a associatividade apenas determinam como as expressões são
  agrupadas, mas não especificam a ordem de avaliação. O PHP
  (geralmente) não especifica em que ordem as expressões são avaliadas,
  então códigos que assumem ordens específicas de avaliação devem ser evitados
  porque o comportamento pode ser alterado entre versões do PHP ou dependendo
  do código em volta.
  <div class="example" id="example-3">
   <p><strong>Exemplo #3 Ordem de avaliação não definida</strong></p>
   <div class="example-contents">
<div class="annotation-non-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$a </span><span style="color: #007700">+ </span><span style="color: #0000BB">$a</span><span style="color: #007700">++; </span><span style="color: #FF8000">// pode exibir 2 ou 3<br /><br /></span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$array</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">] = </span><span style="color: #0000BB">$i</span><span style="color: #007700">++; </span><span style="color: #FF8000">// pode definir o índice 1 ou 2<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
  <div class="example" id="example-4">
   <p><strong>Exemplo #4 Precedência de <code class="literal">+</code>, <code class="literal">-</code> e <code class="literal">.</code></strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$x </span><span style="color: #007700">= </span><span style="color: #0000BB">4</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">// esta linha pode resultar em uma saída inesperada:<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. </span><span style="color: #0000BB">$x</span><span style="color: #007700">-</span><span style="color: #0000BB">1 </span><span style="color: #007700">. </span><span style="color: #DD0000">", ou assim eu espero\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// a precedência desejada pode ser aplicada utilizando parênteses:<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. (</span><span style="color: #0000BB">$x</span><span style="color: #007700">-</span><span style="color: #0000BB">1</span><span style="color: #007700">) . </span><span style="color: #DD0000">", ou assim eu espero\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// isto não é permitido e lança um TypeError:<br /></span><span style="color: #007700">echo ((</span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. </span><span style="color: #0000BB">$x</span><span style="color: #007700">) - </span><span style="color: #0000BB">1</span><span style="color: #007700">) . </span><span style="color: #DD0000">", ou assim eu espero\n"</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="annotation-interactive cdata"><pre>
-1, ou assim eu espero
-1, ou assim eu espero
Fatal error: Uncaught TypeError: Unsupported operand types: string - int
</pre></div>
   </div>
  </div>
  <div class="example" id="example-5">
   <p><strong>Exemplo #5 Antes do PHP 8, <code class="literal">+</code>, <code class="literal">-</code> e <code class="literal">.</code> tinham a mesma precedência</strong></p>
   <div class="example-contents">
<div class="annotation-non-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$x </span><span style="color: #007700">= </span><span style="color: #0000BB">4</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">// this line might result in unexpected output:<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. </span><span style="color: #0000BB">$x</span><span style="color: #007700">-</span><span style="color: #0000BB">1 </span><span style="color: #007700">. </span><span style="color: #DD0000">", ou assim eu espero\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// porque é avaliada como esta linha (antes do PHP  8.0.0):<br /></span><span style="color: #007700">echo ((</span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. </span><span style="color: #0000BB">$x</span><span style="color: #007700">) - </span><span style="color: #0000BB">1</span><span style="color: #007700">) . </span><span style="color: #DD0000">", ou assim eu espero\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// a precedência desejada pode ser aplicada utilizando parênteses:<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"x menos um é igual a " </span><span style="color: #007700">. (</span><span style="color: #0000BB">$x</span><span style="color: #007700">-</span><span style="color: #0000BB">1</span><span style="color: #007700">) . </span><span style="color: #DD0000">", ou assim eu espero\n"</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="annotation-interactive cdata"><pre>
-1, ou assim eu espero
-1, ou assim eu espero
x menos um é igual a 3, ou assim eu espero
</pre></div>
   </div>
  </div>
 </p>
 <blockquote class="note"><p><strong class="note">Nota</strong>: 
  <p class="para">
   Embora o <code class="literal">=</code> tenha uma precedência menor que
   a maioria dos operadores, o PHP ainda permite expressões
   similares a <code class="literal">if (!$a = foo())</code>,
   onde o valor retornado de <code class="literal">foo()</code> é
   colocado em <var class="varname">$a</var>.
  </p>
 </p></blockquote>
 <div class="sect2">
  <h3 class="title">Registro de Alterações</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versão</th>
      <th>Descrição</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       Concatenação de strings (<code class="literal">.</code>) tem uma precedência menor que
       adição/subtração (<code class="literal">+</code> e <code class="literal">-</code>) e
       shift de bits à esquerda/direita (<code class="literal">&lt;&lt;</code> e <code class="literal">&gt;&gt;</code>);
       anteriormente ele tinha a mesma precedência que <code class="literal">+</code> e <code class="literal">-</code>
       uma precedência maior que <code class="literal">&lt;&lt;</code> e <code class="literal">&gt;&gt;</code>.
      </td>
     </tr>

     <tr>
      <td>8.0.0</td>
      <td>
       O operador ternário (<code class="literal">? :</code>) agora é não associativo;
       anteriormente associava a esquerda.
      </td>
     </tr>

     <tr>
      <td>7.4.0</td>
      <td>
       Depender da precedência da concatenação de strings (<code class="literal">.</code>) em relação
       à adição/subtração (<code class="literal">+</code> ou <code class="literal">-</code>) ou
       shift de bits a esquerda/direta (<code class="literal">&lt;&lt;</code> ou <code class="literal">&gt;&gt;</code>),
       ou seja, os usar numa mesma expressão, foi descontinuado.
      </td>
     </tr>

     <tr>
      <td>7.4.0</td>
      <td>
       Depender da associatividade à esquerda do operador ternário (<code class="literal">? :</code>),
       ou seja, o utilizar em várias expressões sem parênteses, foi descontinuado.
      </td>
     </tr>

    </tbody>
   
  </table>

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