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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.array" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>array</refname>
  <refpurpose>Crea un array</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>array</methodname>
   <methodparam rep="repeat"><type>mixed</type><parameter>values</parameter></methodparam>
  </methodsynopsis>
  <para>
   Crea un array. Consulte la sección sobre los
   <link linkend="language.types.array">tipos array</link> para obtener más información
   sobre qué es un array, incluyendo los detalles sobre la sintaxis alternativa de corchetes (<literal>[]</literal>).
  </para>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>values</parameter></term>
     <listitem>
      <para>
       La sintaxis "índice =&gt; valor", separada por comas,
       define los índices y sus valores. Un índice puede ser una
       cadena o un número. Si el índice se omite, se generará automáticamente un índice numérico
       (comenzando en 0). Si el índice es un entero, el siguiente índice generado tomará el valor del índice más grande + 1. Tenga en cuenta que si se definen dos índices idénticos, el último sobrescribirá al primero.
      </para>
      <para>
       Tener una coma después de definir la última entrada, aunque innecesario,
       es una sintaxis válida.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve un array de los argumentos. Los argumentos pueden proporcionar
   un índice utilizando el operador <literal>=&gt;</literal>.
   Consulte la sección sobre los <link linkend="language.types.array">tipos array</link>
   para obtener más información sobre qué es un array.
  </para>
 </refsect1>
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   El siguiente ejemplo muestra cómo crear un array de dos dimensiones,
   cómo especificar los índices de un array asociativo, y cómo
   generar automáticamente índices numéricos.
   <example>
    <title>Ejemplo con <function>array</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$fruits = array (
    "fruits"  => array("a" => "orange", "b" => "banana", "c" => "apple"),
    "numbers" => array(1, 2, 3, 4, 5, 6),
    "holes"   => array("first", 5 => "second", "third")
);
print_r($fruits);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>Índices automáticos con <function>array</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$array = array(1, 1, 1, 1,  1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="php">
<![CDATA[
Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)
]]>
    </screen>
   </example>
  </para>
  <para>
   Observe que el índice '3' se define dos veces, y finalmente
   conserva su último valor de 13. El índice '4' se define después
   del índice '8', y el siguiente índice generado (valor 19) es
   9, ya que el índice más grande es entonces 8.
  </para>
  <para>
   Este ejemplo crea un array cuyos índices comienzan en 1.
   <example>
    <title>Índices comenzando en 1 con <function>array</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$firstQuarter = array(1 => 'January', 'February', 'March');
print_r($firstQuarter);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Array
(
    [1] => January
    [2] => February
    [3] => March
)
]]>
    </screen>
   </example>
  </para>
  <para>
   Al igual que en Perl, puede acceder a un valor de un array
   en comillas dobles. Sin embargo, con PHP, debe rodear su array con llaves.
   <example>
    <title>Acceder a un array en comillas dobles</title>
    <programlisting role="php">
<![CDATA[
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 <refsect1 role="notes">
  &reftitle.notes;
  <para>
   <note>
    <para>
     <function>array</function> es un constructor de lenguaje utilizado
     para representar literalmente los arrays, pero en ningún caso es una función regular.
    </para>
   </note>
  </para>
 </refsect1>
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>array_pad</function></member>
    <member><function>list</function></member>
    <member><function>count</function></member>
    <member><function>range</function></member>
    <member>&foreach;</member>
    <member>El tipo <link linkend="language.types.array">array</link></member>
   </simplelist>
  </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:"~/.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
-->