a b c d e f g h i j k l m n o p q r s t u v w x y z

Описание функции array

array

(unknown)
array - создаёт массив.

Описание

array array ([mixed ...])
Возвращает массив параметров. Параметры могут быть заданы по индексу с операцией => .

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

Синтаксис пар "индекс => значение", разделённых запятыми, определяет индекс массива и значение по этому индексу.
Индекс может иметь строковой или числовой тип. Если индекс опущен, автоматически генерируется целочисленный/integer индекс, начиная с 0. Если индекс это целое число, следующим сгенерированным индексом будет большее целое число index + 1. Обратите внимание, что, когда определены два идентичных индекса, последний перезаписывает первый.
В следующем примере показано, как создать двухмерный массив, как специфицировать ключи для ассоциативного массива и как skip-and-continue (пропустить-и-продолжить) числовые индексы в нормальных массивах.

Пример 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. Индекс с базой 1



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

выведет:



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

См. также array_pad() , list() и range() .