<?xml version="1.0" encoding="iso-8859-1"?>
  <chapter id="language.operators">
   <title>Operadores</title>
   <simpara>
   </simpara>

   <sect1 id="language.operators.arithmetic">
    <title>Operadores Aritmticos</title>
    <simpara>
     Lembra-se da aritmtica bsica da escola? Estes operadores funcionam 
     exatamente como aqueles.
    </simpara>

    <table>
     <title>Operadores Aritmticos</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>exemplo</entry>
        <entry>nome</entry>
        <entry>resultado</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>$a + $b</entry>
        <entry>Adio</entry>
        <entry>Soma de $a e $b.</entry>
       </row>
       <row>
        <entry>$a - $b</entry>
        <entry>Subtrao</entry>
        <entry>Diferena entre $a e $b.</entry>
       </row>
       <row>
        <entry>$a * $b</entry>
        <entry>Multiplicao</entry>
        <entry>Produto de $a e $b.</entry>
       </row>
       <row>
        <entry>$a / $b</entry>
        <entry>Diviso</entry>
        <entry>Quociente de $a por $b.</entry>
       </row>
       <row>
        <entry>$a % $b</entry>
        <entry>Mdulo</entry>
        <entry>Resto de $a dividido por $b.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>

<!-- Isto parece estar impreciso. Diviso sempre retorna ponto flutuante.
    <simpara>
     O operador de diviso ("/") retorna um valor inteiro (o resultado de uma 
     diviso de inteiros) se os dois operandos so inteiros (ou strings que 
     foram convertidos para inteiros). Se o operando  um valor de ponto
     flutuante,  realizada a diviso de ponto flutuante.
    </simpara>
--></sect1>

   <sect1 id="language.operators.assignment">
    <title>Operadores de Atribuio</title>
    <simpara>
     O operador bsico de atribuio  "=". A sua primeira inclinao deve ser 
     a de pensar nisto como " igual". No. Isto quer dizer, na verdade, que o 
     operando da esquerda recebe o valor da expresso da direita (ou seja, 
     " setado para").
    </simpara>
    <para>
     O valor de uma expresso de atribuio  o valor atribudo. Ou seja, o valor
     de "$a = 3"  3. Isto permite que voc faa alguns truques:
     <informalexample><programlisting>
$a = ($b = 4) + 5; // $a  igual a 9 agora, e $b foi setado para 4.
</programlisting></informalexample>
    </para>
    <para>
     Alm do operador bsico de atribuio, h "operadores combinados" para todos
     os operadores binrios, aritmticos e de string que permitem a voc usar um
     valor em uma expresso e ento setar seu valor para o resultado daquela
     expresso. Por exemplo: <informalexample><programlisting>
$a = 3;
$a += 5; // seta $a para 8, como se dissssemos: $a = $a + 5;
$b = "Ol ";
$b .= "A!"; // seta $b para "Ol A!", como $b = $b . "A!";
</programlisting></informalexample>
    </para>

   <para>
	Note que a atribuio copia a varivel original para a nova (atribuio por
	valor), assim a mudana de uma no afeta a outra. Isto tambm pode ser 
	relevncia se voc precisa copiar algo como uma grande matriz dentro de um
	'loop' apertado. O PHP4 suporta atribuies por referncia, usando a sintaxe
	<computeroutput>$var = &amp;$othervar;</computeroutput>, mas isto no  
	possvel no PHP3. 'Atribuio por referncia' significa que ambas as variveis 
	acabam apontando para os mesmos dados, e nada  copiado para lugar nenhum.
   </para>

  </sect1>

   <sect1 id="language.operators.bitwise">
    <title>Operador Bit-a-bit</title>
    <simpara>
     Operadores bit-a-bit permitem que voc acione ou desligue bits especficos dentro  
     de um inteiro.
    </simpara>

    <table>
     <title>Operadores Bit-a-bit</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>exemplo</entry>
        <entry>nome</entry>
        <entry>resultado</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>$a &amp; $b</entry>
        <entry>E</entry>
        <entry>Os bits que esto setados tanto em $a quanto em $b so setados.</entry>
       </row>
       <row>
        <entry>$a | $b</entry>
        <entry>OU</entry>
        <entry>Os bits que esto setados em $a ou em $b so setados.</entry>
       </row>
       <row>
        <entry>$a ^ $b</entry>
        <entry>XOR</entry>
        <entry>Os bits que esto setados em $a ou em $b, mas no em ambos, so setados.</entry>
       </row>
       <row>
        <entry>~ $a</entry>
        <entry>NO</entry>
        <entry>Os bits que esto setados em $a no so setados, e vice-versa.</entry>
       </row>
       <row>
        <entry>$a &lt;&lt; $b</entry>
        <entry>Deslocamento  esquerda</entry>
        <entry>Desloca os bits de $a $b passos para a esquerda (cada passo significa "multiplica por dois")</entry>
       </row>
       <row>
        <entry>$a &gt;&gt; $b</entry>
        <entry>Deslocamento  direita</entry>
        <entry>Desloca os bits de $a $b passos para a direita (cada passo significa "divide por dois")</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
  </sect1>



   <sect1 id="language.operators.comparison">
    <title>Operadores de Comparao</title>
    <simpara>
     Operadores de comparao, como os seus nomes implicam, permitem que voc
     compare dois valores.
    </simpara>

    <table>
     <title>Operadores de comparao</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>exemplo</entry>
        <entry>nome</entry>
        <entry>resultado</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>$a == $b</entry>
        <entry>Igual</entry>
        <entry>Verdadeiro se $a  igual a $b.</entry>
       </row>
       <row>
        <entry>$a === $b</entry>
        <entry>Idntico</entry>
        <entry>Verdadeiro se $a  igual a $b, e eles so do mesmo tipo.
		(somente para PHP4)</entry>
       </row>
       <row>
        <entry>$a != $b</entry>
        <entry>Diferente</entry>
        <entry>Verdadeiro se $a no  igual a $b.</entry>
       </row>
       <row>
        <entry>$a &lt; $b</entry>
        <entry>Menor que</entry>
        <entry>Verdadeiro se $a  estritamente menor que $b.</entry>
       </row>
       <row>
        <entry>$a &gt; $b</entry>
        <entry>Maior que </entry>
        <entry>Verdadeiro se $a  estritamente maior que $b.</entry>
       </row>
       <row>
        <entry>$a &lt;= $b</entry>
        <entry>Menor ou igual </entry>
        <entry>Verdadeiro se $a  menor ou igual a $b.</entry>
       </row>
       <row>
        <entry>$a &gt;= $b</entry>
        <entry>Maior ou igual</entry>
        <entry>Verdadeiro se $a  maior ou igual a $b.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>

   <para>
     Outro operador condicional  o operador "?:" (ou trinrio), que opera
     como em C e muitas outras linguagens.
	
	<informalexample>
	 <programlisting>
(expr1) ? (expr2) : (expr3);
	 </programlisting>
	</informalexample> 

	Esta expresso  avaliada como <replaceable>expr2</replaceable> se
	<replaceable>expr1</replaceable>  avaliada como verdadeira, e
	<replaceable>expr3</replaceable> se
	<replaceable>expr1</replaceable>  avaliada como falsa.
   </para>
  </sect1>


  <sect1 id="language.operators.errorcontrol">
   <title>Operadores de controle de erro</title>
   
   <simpara>
    O PHP suporta um operador de controle de erro: o sinal 'em' (@). Quando
    ele precede uma expresso em PHP, qualquer mensagem de erro que possa ser 
    gerada por aquela expresso ser ignorada. 
   </simpara>

   <simpara>
    Se a implementao <link linkend="ini.track-errors">track_errors</link>
    estiver habilitada, qualquer mensagem de erro gerada pela expresso ser
    gravada na varivel global $php_errormsg. Esta varivel ser sobreescrita
    em cada erro, assim verifique-a constantemente se voc quiser us-la.
   </simpara>

   <para>
    <informalexample>
     <programlisting role="php">
&lt;?php
/* Erro SQL intencional (aspas extras): */
$res = @mysql_query( "select name, code from 'namelist" ) or
   die( "Falha na Query: erro foi '$php_errormsg'" );
?&gt;
     </programlisting>
    </informalexample>

   </para>

   <simpara>
    Veja tambm <function>error_reporting</function>.
   </simpara>

  </sect1>


  <sect1 id="language.operators.execution">
   <title>Operadores de Execuo</title>
   
   <para>
	O PHP suporta um operador de execuo: acentos graves (``). Note que no so
	apstrofes! O PHP tentar executar o contedo dos acentos graves como um 
	comando do shell; a sada ser retornada (isto , ela no ser simplesmente
	descarregada para a sada; ela pode ser atribuda a uma varivel).

	<informalexample>
	 <programlisting role="php">
$output = `ls -al`;
echo "&lt;pre&gt;$output&lt;/pre&gt;";
	 </programlisting>
	</informalexample>

   </para>

   <para>
	Veja tambm <function>system</function>,
	<function>passthru</function>, <function>exec</function>,
	<function>popen</function>, e
	<function>escapeshellcmd</function>.
   </para>

  </sect1>

  
  <sect1 id="language.operators.increment">
   <title>Operadores de Incremento/Decremento</title>

   <para>
	O PHP suporta operadores de pr e ps-incremento e decremento
	no estilo C.
   </para>

    <table>
     <title>Operadores de Incremento/Decremento</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>exemplo</entry>
        <entry>nome</entry>
        <entry>efeito</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>++$a</entry>
        <entry>Pr-incremento</entry>
        <entry>Incrementa $a de um, e ento retorna $a.</entry>
       </row>
       <row>
        <entry>$a++</entry>
        <entry>Ps-incremento</entry>
        <entry>Retorna $a, e ento incrementa $a de um.</entry>
       </row>
       <row>
        <entry>--$a</entry>
        <entry>Pr-decremento</entry>
        <entry>Decrementa $a de um, e ento retorna $a.</entry>
       </row>
       <row>
        <entry>$a--</entry>
        <entry>Ps-decremento</entry>
        <entry>Retorna $a, e ento decrementa $a de um.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>

   <para>
	Aqui est um script de exemplo simples:
	<informalexample>
	 <programlisting>
&lt;?php
echo "&lt;h3&gt;Ps-incremento&lt;/h3&gt;";
$a = 5;
echo "Deve ser 5: " . $a++ . "&lt;br&gt;\n";
echo "Deve ser 6: " . $a . "&lt;br&gt;\n";

echo "&lt;h3&gt;Pr-incremento&lt;/h3&gt;";
$a = 5;
echo "Deve ser 6: " . ++$a . "&lt;br&gt;\n";
echo "Deve ser 6: " . $a . "&lt;br&gt;\n";

echo "&lt;h3&gt;Ps-decremento&lt;/h3&gt;";
$a = 5;
echo "Deve ser 5: " . $a-- . "&lt;br&gt;\n";
echo "Deve ser 4: " . $a . "&lt;br&gt;\n";

echo "&lt;h3&gt;Pr-decremento&lt;/h3&gt;";
$a = 5;
echo "Deve ser 4: " . --$a . "&lt;br&gt;\n";
echo "Deve ser 4: " . $a . "&lt;br&gt;\n";
?&gt;	  
	 </programlisting>
	</informalexample>
   </para>

  </sect1>


  <sect1 id="language.operators.logical">
    <title>Operadores Lgicos</title>

    <table>
     <title>Operadores Lgicos</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>exemplo</entry>
        <entry>nome</entry>
        <entry>resultado</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>$a and $b</entry>
        <entry>E</entry>
        <entry>Verdadeiro se tanto $a quanto $b so verdadeiros.</entry>
       </row>
       <row>
        <entry>$a or $b</entry>
        <entry>OU</entry>
        <entry>Verdadeiro se $a ou $b so verdadeiros.</entry>
       </row>
       <row>
        <entry>$a xor $b</entry>
        <entry>XOR</entry>
        <entry>Verdadeiro se $a ou $b so verdadeiros, mas no ambos.</entry>
       </row>
       <row>
        <entry>! $a</entry>
        <entry>NO</entry>
        <entry>Verdadeiro se $a no  verdadeiro.</entry>
       </row>
       <row>
        <entry>$a &amp;&amp; $b</entry>
        <entry>E</entry>
        <entry>Verdadeiro se tanto $a quanto $b so verdadeiros.</entry>
       </row>
       <row>
        <entry>$a || $b</entry>
        <entry>OU</entry>
        <entry>Verdadeiro se $a ou $b so verdadeiros.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>

   <simpara>
	A razo para as duas variantes dos operandos "and" e "or"
	 que eles operam com precedncias diferentes. (Veja
	<link linkend="language.operators.precedence">Precedncia de Operadores
	</link>.)
   </simpara>
  </sect1>

   <sect1 id="language.operators.precedence">
    <title>Precedncia de Operadores</title>
    <para>
     A precedncia de um operador especifica quo "intimamente" ele liga duas
     expresses. Por exemplo, na expresso <literal>1 + 5 * 3</literal>, a
     resposta  16 e no 18 porque o operador de multiplicao ("*") tem uma 
     precedncia mais alta que o operador de adio ("+").</para>
    <para>
     A tabela a seguir lista a precedncia de operadores com os operadores 
     de menor precedncia listados primeiro.

    <table>
     <title>Precedncia de Operadores</title>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>Associatividade</entry>
        <entry>Operadores</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>esquerda</entry>
        <entry>,</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>or</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>xor</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>and</entry>
       </row>
       <row>
        <entry>direita</entry>
        <entry>print</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>= += -= *= /= .= %= &amp;= |= ^= ~= &lt;&lt;= &gt;&gt;=</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>? :</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>||</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>&amp;&amp;</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>|</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>^</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>&amp;</entry>
       </row>
       <row>
        <entry>non-associative</entry>
        <entry>== != ===</entry>
       </row>
       <row>
        <entry>non-associative</entry>
        <entry>&lt; &lt;= &gt; &gt;=</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>&lt;&lt; &gt;&gt;</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>+ - .</entry>
       </row>
       <row>
        <entry>esquerda</entry>
        <entry>* / %</entry>
       </row>
       <row>
        <entry>direita</entry>
        <entry>! ~ ++ -- (int) (double) (string) (array) (object) @</entry>
       </row>
       <row>
        <entry>direita</entry>
        <entry>[</entry>
       </row>
       <row>
        <entry>non-associative</entry>
        <entry>new</entry>
       </row>
      </tbody>
     </tgroup>
    </table></para></sect1>

  <sect1 id="language.operators.string">
   <title>Operadores de String</title>
   <simpara>
	H dois operadores de string. O primeiro  o operador de concatenao
	('.'), que retorna a concatenao dos seus argumentos direito e esquerdo.
	O segundo  o operador de atribuio de concatenao ('.='). Por favor 
	leia <link linkend="language.operators.assignment">Operadores de Atribuio
	</link> para mais informaes.
   </simpara>
   <para>
	<informalexample>
	 <programlisting>
$a = "Ol ";
$b = $a . "mundo!"; // agora $b contm "Ol mundo!"

$a = "Ol ";
$a .= "mundo!"; // agora $a contm "Ol mundo!"
     </programlisting>
	</informalexample>
   </para>
  </sect1>


  </chapter>
 
 <!-- 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:"../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 -->