Added: phpdoc/ca/trunk/language/control-structures/switch.xml
===================================================================
--- phpdoc/ca/trunk/language/control-structures/switch.xml	                        (rev 0)
+++ phpdoc/ca/trunk/language/control-structures/switch.xml	2011-09-18 08:46:41 UTC (rev 316919)
@@ -0,0 +1,254 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 316587 Maintainer: uri Status: ready -->
+
+<sect1 xml:id="control-structures.switch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title><literal>switch</literal></title>
+ <?phpdoc print-version-for="switch"?>
+ <simpara>
+  La sentencia <literal>switch</literal> és similar a una successió de
+  sentencies IF de la mateixa expressió. En forces ocasions, es possible que
+  es vulgui comparar la mateixa variable (o expressió) amb distints valors,
+  i executar un fragment de codi distint en relació al valor que aquella prengui.
+  Aquesta és exactament la funció de <literal>switch</literal>.
+ </simpara>
+ <note>
+  <simpara>
+  Cal anotar que, a diferencia de altres llenguatges, la sentencia
+  <link linkend="control-structures.continue">continue</link>
+  aplicada al switch respon de forma similar a un <literal>break</literal>. De tal manera que si es
+  té un switch dins un loop i es vol que aquell continuï fins la següent iteració del
+  loop que el conté, caldrà utilitzar un <literal>continue 2</literal>.
+  </simpara>
+ </note>
+ <note>
+  <para>
+  Tingues en compte que el switch/case realitza
+   <link linkend="types.comparisions-loose">comparacions flexibles</link>.
+  </para>
+ </note>
+ <para>
+  Els següents dos exemples mostren dos camins diferents alhora d'escriure la
+  mateixa cosa, la primera utilitzant un seguit d'expressions <literal>if</literal>
+  i <literal>elseif</literal>, l'altre utilitzant l'expressió
+  <literal>switch</literal>:
+  <example>
+   <title>Estructura d'un <literal>switch</literal></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+if ($i == 0) {
+    echo "i és igual a 0";
+} elseif ($i == 1) {
+    echo "i és igual a 1";
+} elseif ($i == 2) {
+    echo "i és igual a 2";
+}
+
+switch ($i) {
+    case 0:
+        echo "i és igual a 0";
+        break;
+    case 1:
+        echo "i és igual a 1";
+        break;
+    case 2:
+        echo "i és igual a 2";
+        break;
+}
+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>L'estructura d'un <literal>switch</literal> permet l'ús de cadenes (strings)</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch ($i) {
+    case "poma":
+        echo "i és una poma";
+        break;
+    case "bicicleta":
+        echo "i és una bicicleta";
+        break;
+    case "groc":
+        echo "i és groc";
+        break;
+}
+?>
+]]>
+   </programlisting>
+  </example>
+ </para>
+ <para>
+  És important entendre com la sentencia <literal>switch</literal>
+  es executada per evitar errors. La sentencia
+  <literal>switch</literal> executa línia per línia
+  (en realitat, sentencia per sentencia). A l'inici, cap codi és
+  executat. Només quan una sentencia <literal>case</literal> es correspon
+  amb el valor busca't per <literal>switch</literal>, PHP començarà a executar
+  les sentencies. Continuant executant-les totes fins al final del bloc
+  <literal>switch</literal>, o fins a trobar una sentencia
+  <literal>break</literal> de trencament.  Així doncs, si no s'escriu cap
+  sentencia <literal>break</literal> com a darrera sentencia d'un case,
+  PHP continuarà executant aquelles sentencies pròpies de tots els casos que
+  precedeixin el cas on s'hagi donat la coincidència. Per exemple:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch ($i) {
+    case 0:
+        echo "i és igual a 0";
+    case 1:
+        echo "i és igual a 1";
+    case 2:
+        echo "i és igual a 2";
+}
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <simpara>
+  Aquí, si <varname>$i</varname> és igual a 0, PHP executarà tots les sentencies
+  echo presents. Si <varname>$i</varname> és igual a 1, PHP executarà les dues
+  darreres. Només s'obtindria el resultat esperat ('i és igual a 2')
+  en el cas que <varname>$i</varname> fos igual a 2.  Per tant,
+  és important no obviar les sentencies <literal>break</literal>
+  (a menys és clar, que es desitgi evitar-ne l'ús en atenció a determinats
+  comportaments circumstancials).
+ </simpara>
+ <simpara>
+  En la sentencia <literal>switch</literal>, la condició es avaluada només el
+  primer cop i el resultat de tal avaluació serà contrastat amb cadascun dels casos
+  <literal>case</literal> presents. Recordem aquí que en una sentencia <literal>elseif</literal>
+  la condició es avaluada cada cop. Així, si la condició és més complexa que
+  una simple comparació del tipus i/o (and/or) dins dels bucles interns, la utilització d'un
+  <literal>switch</literal> pot resoldre's amb major rapidesa.
+ </simpara>
+ <para>
+  La llista de sentencies d'un cas (case) pot estar buida, la qual cosa simplement
+  passarà el control a la llista següent de sentencies del següent cas.
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch ($i) {
+case 0:
+case 1:
+case 2:
+    echo "i és menor a 3 però no és negatiu";
+    break;
+case 3:
+    echo "i és el 3";
+}
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <para>
+  Un cas especial és l'ús del case <literal>default</literal>.  El qual qual
+  s'executarà sempre que no s'hagi trobat coincidència en cap dels casos previstos.
+  Per exemple:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch ($i) {
+    case 0:
+        echo "i és igual a 0";
+        break;
+    case 1:
+        echo "i és igual a 1";
+        break;
+    case 2:
+        echo "i és igual a 2";
+        break;
+    default:
+       echo "i no és igual a 0, 1 o 2";
+}
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <para>
+  L'expressió avaluada en el <literal>case</literal> pot ser de tipus simple
+  (simple type), això és, un enter (integer), un nombre amb coma flotant (floating-point
+  numbers) o una cadena (strings).  Matrius (arrays) o objectes (POO) no poden ser
+  utilitzats aquí a menys que aquells es descomponguin en un tipus simple.
+ </para>
+ <para>
+  La sintaxis alternativa per a les estructures de control es compatible amb
+  els switches. Per a més informació, vegi's <link
+  linkend="control-structures.alternative-syntax">Sintaxis alternativa
+  per a les estructures de control</link>.
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch ($i):
+    case 0:
+        echo "i és igual a 0";
+        break;
+    case 1:
+        echo "i és igual a 1";
+        break;
+    case 2:
+        echo "i és igual a 2";
+        break;
+    default:
+        echo "i no és igual a 0, 1 o 2";
+endswitch;
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <para>
+  També és possible utilitzar el punt i coma enlloc dels dos punts després del cas així:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+switch($menjar)
+{
+    case 'carn';
+    case 'peix';
+    case 'verdura';
+        echo 'Bona elecció';
+    break;
+    default;
+        echo 'Si us plau faci una nova selecció...';
+    break;
+}
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+</sect1>
+
+<!-- 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
+-->


Property changes on: phpdoc/ca/trunk/language/control-structures/switch.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native