php-doc-en/reference/array/functions/array.xml

<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.110 -->
  <refentry id="function.array">
   <refnamediv>
    <refname>array</refname>
    <refpurpose>
     Creează un tablou.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descriere</title>
     <methodsynopsis>
      <type>array</type><methodname>array</methodname>
      <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
    <para>
    Returnează un tablou format din parametri. Parametrii pot deveni indecşi 
	utilizând operatorul  <literal>=&gt;</literal>.
    </para>
    <para>
     <note>
      <para>
       <function>array</function> este un constructor al limbajului PHP
	   utilizat pentru a reprezenta tablourile, şi nu o funcţie propriu-zisă.
      </para>
     </note>
    </para>
    <para>
     Sintaxa "index =&gt; values", separată de virgule, defineşte indecşi
	 şi valori. Indecşii pot fi de tipul şir de caractere sau numerici. Când sunt omişi,
	 indecşii sunt generaţi automat sub forma unor numere întregi, începând
	 cu 0. Atunci când un index este un număr întreg, următorul index generat va fi
	 cel mai mare index din tablou, incrementat cu 1. Dacă sunt definiţi doi indecşi identici,
	 ultimul îl va suprascrie pe primul.
    </para>
    <para>
     Următorul exemplu demonstrează cum se creează un
	 tablou bidimensional, cum se specifică cheile
	 pentru tablouri asociative şi cum să săriţi peste indicii numerici
	 în tablouri normale.
     <example>
      <title>Exempul de utilizare al funcţiei <function>array</function></title>
      <programlisting role="php">
<![CDATA[
$fruits = array (
    "fruits"  => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"),
    "numbers" => array (1, 2, 3, 4, 5, 6),
    "holes"   => array ("first", 5 => "second", "third")
);
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>Indecşi automaţi cu <function>array</function></title>
      <programlisting role="php">
<![CDATA[
$array = array( 1, 1, 1, 1,  1, 8=>1,  4=>1, 19, 3=>13);
print_r($array);
]]>
      </programlisting>
      <para>
       va afişa :
       <screen role="php">
<![CDATA[
Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)
]]>
       </screen>
      </para>
     </example>
     Observaţi că indexul '3' este definit de două ori şi că păstrează valoarea finală 13.
     Indexul 4 este definit după indexul 8, iar următorul index generat (valoarea 19)
     este 9, întrucât cel mai mare index era 8.
    </para>
    <para>
     În exemplul următor vom crea un tablou cu baza 1.
     <example>
      <title>index bazat pe 1 cu <function>array</function></title>
      <programlisting role="php">
<![CDATA[
$firstquarter  = array(1 => 'January', 'February', 'March');
print_r($firstquarter);
]]>
      </programlisting>
      <para>
       will display :
       <screen>
<![CDATA[
Array
(
    [1] => 'January'
    [2] => 'February'
    [3] => 'March'
)
]]>
       </screen>
      </para>
     </example>
    </para>
    <para>
     Vezi, de asemenea, şi <function>array_pad</function>,
     <function>list</function>, precum şi <function>range</function>.
    </para>
   </refsect1>
  </refentry>

<!-- 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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->