Descripción

array(mixed ...$values): array

Crea un array. Consulte la sección sobre los tipos array para obtener más información sobre qué es un array, incluyendo los detalles sobre la sintaxis alternativa de corchetes ([]).

Parámetros

values

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 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.

Tener una coma después de definir la última entrada, aunque innecesario, es una sintaxis válida.

Valores devueltos

Devuelve un array de los argumentos. Los argumentos pueden proporcionar un índice utilizando el operador =>. Consulte la sección sobre los tipos array para obtener más información sobre qué es un array.

Ejemplos

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
$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);
?>

Ejemplo #2 Índices automáticos con array()

<?php
$array = array(1, 1, 1, 1,  1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>

El ejemplo anterior mostrará:

Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

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.

Este ejemplo crea un array cuyos índices comienzan en 1.

Ejemplo #3 Índices comenzando en 1 con array()

<?php
$firstQuarter = array(1 => 'January', 'February', 'March');
print_r($firstQuarter);
?>

El ejemplo anterior mostrará:

Array
(
    [1] => January
    [2] => February
    [3] => March
)

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.

Ejemplo #4 Acceder a un array en comillas dobles

<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>

Notas

Nota:
array() es un constructor de lenguaje utilizado para representar literalmente los arrays, pero en ningún caso es una función regular.

Ver también

array_pad() - Completa un array con un valor hasta la longitud especificada
list() - Asigna variables como si fueran un array
count() - Cuenta todos los elementos de un array o en un objeto Countable
range() - Crea un array que contiene un intervalo de elementos
foreach
El tipo array