archived-doc-ro/reference/array/functions/array.xml

<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.4 $ -->
<!-- EN-Revision: 1.0 Maintainer: adiju Status: outdated -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.110 -->
  <refentry xml:id="function.array" xmlns="http://docbook.org/ns/docbook">
   <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
-->