array

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

array — Crea un array

Descripción

array(mixed ...$valores): 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 ([]).

Parámetros

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.

Valores devueltos

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.

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
$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!

?>

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 2 notes

down

116

ole dot aanensen at gmail dot com ¶

10 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
)

down

goktug-51 at hotmail dot com ¶

2 months ago

I want to point smt important about accessing array value from within double quotes that didn't get mentioned in the article.

As article says you can access array values from within double quotes, using the curly braces syntax. However, you can also access it without curly braces and array access quotes:

$foo = array('bar' => 'baz');

echo "Hello $foo[bar]";

returns "Hello baz" with no error

Note: I didn't check for all of the PHP versions.

＋add a note