(PHP 4, PHP 5, PHP 7, PHP 8)
array — Crea un array
Crea un array. Léase la sección sobre los
tipos de array para más información
sobre lo que es un array, incluyendo detalles sobre la sintaxis alternativa de corchetes ([]
).
valores
La sintaxis "índice => valor", separada por comas, define los índices y sus valores. Un índice puede ser una cadena o un número. Si el índice es omitido, un índice numérico será automáticamente generado (comenzando en 0). Si el índice es un entero, el próximo índice generado tomará el valor del índice más grande + 1. Tenga en cuenta que si dos índices idénticos son definidos, el último sobrescribirá al primero.
Tener una coma después de definir la última entrada, aunque inútil, es una sintaxis válida.
Devuelve un array de los argumentos. Los argumentos pueden proporcionar
un índice utilizando el operador =>
.
Léase la sección sobre los tipos de array
para más información sobre lo que es un array.
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.
Ejemplo #1 Ejemplo con array()
<?php
$frutas = array (
"frutas" => array("a" => "naranja", "b" => "plátano", "c" => "manzana"),
"números" => array(1, 2, 3, 4, 5, 6),
"agujeros" => array("primero", 5 => "segundo", "tercero")
);
?>
Ejemplo #2 Índice automático con array()
<?php
$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>
El resultado del ejemplo sería:
Array ( [0] => 1 [1] => 1 [2] => 1 [3] => 13 [4] => 1 [8] => 1 [9] => 19 )
Tenga en cuenta que el índice '3' es definido dos veces, y conserva finalmente su último valor de 13. El índice '4' es definido después del índice '8', y el índice generado siguiente (valor 19) es 9, ya que el índice más grande es entonces 8.
Este ejemplo crea un array cuyos índices comienzan en 1.
Ejemplo #3 Índice comenzando en 1 con array()
<?php
$primertrimestre = array(1 => 'Enero', 'Febrero', 'Marzo');
print_r($primertrimestre);
?>
El resultado del ejemplo sería:
Array ( [1] => Enero [2] => Febrero [3] => Marzo )
Al igual que en Perl, se puede acceder a un valor de un array en comillas dobles. Sin embargo, con PHP, se deben rodear el array con llaves.
Ejemplo #4 Acceder a un array en comillas dobles
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
Nota:
array() es un constructor de lenguaje utilizado para representar literalmente los arrays, pero en ningún caso es una función regular.