array

    (PHP 4, PHP 5, PHP 7, PHP 8)

    array — Crea un array

    Descripción

    function 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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    113
    ole dot aanensen at gmail dot com
    12 years ago
    As of PHP 5.4.x you can now use 'short syntax arrays' which eliminates the need of this function.

Example #1 'short syntax array'
<?php
    $a = [1, 2, 3, 4];
    print_r($a);
?>

The above example will output:
Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
)

Example #2 'short syntax associative array'
<?php
    $a = ['one' => 1, 'two' => 2, 'three' => 3, 'four' => 4];
    print_r($a);
?>

The above example will output:
Array
(
    [one] => 1
    [two] => 2
    [three] => 3
    [four] => 4
)
    ＋add a note
    To Top