array

(PHP 4, PHP 5)

array — Crear una matriz

Descripción

array array ( mixed $... )

Devuelve una matriz con los parámetros que se le pasan. A dichos parámetros se les puede dar un índice usando el operador =>. Lea la sección sobre los tipos de matrices para más información sobre matrices.

Note: array() es una construcción del lenguaje que se utiliza para representar matrices literales, no una función regular.

La forma "índice => valor" separada por comas, define índices y valores. el índice puede ser de tipo cadena o numérico. Cuando el índice es omitido, se genera automáticamente un índice numérico, empezando en cero. Si el índice es un entero, el siguiente índice generado será igual al índice con número mayor + 1. Note que cuando se definen dos índices idénticos, el último sobre escribe al primero.

Tener una coma después del último elemento de la matriz, aunque inusual, es sintácticamente valido.

El siguiente ejemplo demuestra cómo crear una matriz bidimensional, cómo especificar claves para matrices asociativas, y cómo especificar índices no consecutivos en matrices normales.

Example#1 Ejemplo de array()


<?php
$frutas = array (
    "frutas"  => array("a"=>"naranja", "b"=>"pl&aacute;tano", "c"=>"manzana"),
    "n&uacute;meros" => array(1, 2, 3, 4, 5, 6),
    "hoyos"   => array("primero", 5 => "segundo", "tercero")
);
?>

Example#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 seria:

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

Note que el índice '3' es definido dos veces, y permanece su valor final de '13'. El índice 4 es definido depués del índice 8, y en seguida se genera el índice 9 (para el valor 19), porque el índice mayor era 8.

Este ejemplo crea una matriz en donde los índices inician en 1.

Example#3 Índice base 1 con array()


<?php
$primercuarto = array(1 => 'Enero', 'Febrero', 'Marzo');
print_r($primercuarto);
?>

El resultado del ejemplo seria:

Array
(
    [1] => Enero
    [2] => Febrero
    [3] => Marzo
)

Como en Perl, puede accesar un valor de la matriz desde dentro de una cadena contenida en dobles comillas. Sin embargo, con PHP necesitará encerrar la matriz entre las llaves curvas.

Example#4 Accesando una matriz dentro de una cadena


<?php

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

?>

Vea también array_pad(), list(), count(), foreach, range().