array

(PHP 3, PHP 4, PHP 5)

array - Создать массив

Описание

array array ( [mixed ...] )

Возвратить массив параметров. Параметры могут быть заданы с индексом при помощи оператора =>. См. раздел руководства array type для ознакомления с понятием массив.

Замечание: array() - это языковая конструкция для представления массивов, а не функция.

Синтакс "index => values", разделённые запятыми, определяет индексы и их значения. Индекс может быть строкой или целым числом. Если индекс опущен, будет автоматически сгенерирован числовой индекс, начиная с 0. Если индекс - число, следующим сгенерированным индексом будет число, равное максимальному числовому индексу + 1. Обратите внимание, что если определены два одинаковых индекса, последующий переназначит предыдущий.

Использование запятой после последнего определённого элемента массива, в отличие от обычного поведения, является приемлемым синтаксисом.

Последующие примеры демонстрируют создание двухмерного массива, определение ключей ассоциативных массивов и и способ генерации числовых индексов для обычных массивов, если нумерация начинается с произвольного числа.

Пример 1. Пример использования array()

$fruits = array (
 "fruits" => array("a" => "orange", "b" => "banana", "c" => "apple"),
 "numbers" => array(1, 2, 3, 4, 5, 6),
 "holes" => array("first", 5 => "second", "third")
);

Пример 2. Автоматическая индексация array()

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

Результат выполнения данного примера:

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

Обратите внимание, что индекс '3' определён дважды, и содержит последнее значение 13. Индекс 4 определён после индекса 8, и следующий сгенерированный индекс (значение 19) - 9, начиная с максимального индекса 8.

Этот пример создаёт массив, нумерация которого начинаяется с 1.

Пример 3. array(), нумерация которого начинаяется с 1

$firstquarter = array(1 => 'January', 'February', 'March');
print_r($firstquarter);

Результат выполнения данного примера:

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

Как и в Perl, вы имеете доступ к значениям массива внутри кавычек. Однако в PHP нужно заключить ваш массив в фигурные скобки.

Пример 4. Доступ к массиву внутри кавычек

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

Результат выполнения данного примера:

Hello baz!

Пример 5. Перебор списка.

$dossier = array(
  array("name"=>"Thomas Anderson", "burn"=>"1962-03-11"),
  array("name"=>"Keanu Reeves",    "burn"=>"1962-09-02"),
);
for($i=0; $i<count($dossier); $i++)
  echo "{$dossier[$i][name]} was burn {$dossier[$i]['burn']}<br>";

Смотрите также array_pad(), list(), count(), foreach и range().

Все функции array
Описание на ru2.php.net
Описание на php.ru