array
(PHP 4, PHP 5, PHP 7, PHP 8)
array - Створює масив
Опис
array(mixed ...$values): array
Створює масив. Докладніше про масиви розказано у розділі « Масиви ».
Список параметрів
values
Синтаксис — розділені комами «індекс => значення», визначає індекси та значення. Індекс можна вказувати рядком або цілим числом. Якщо індекс не вказано, буде автоматично згенеровано цілочисловий індекс починаючи з 0. Якщо індекс — ціле число, наступним згенерованим індексом буде — найбільший цілочисельний індекс + 1. Зверніть увагу, що якщо визначено два однакові індекси, наступний перезапише попередній.
Замикаюча (висить) кома після останнього елемента масиву хоч і незвичайна, але не порушує синтаксису.
Значення, що повертаються
Повертає масив параметрів. Задати параметри індекс можна оператором =>. Докладніше про масиви розказано у розділі « Масиви ».
Приклади
Наступні приклади показують, як створювати двовимірний масив, як визначати ключі асоціативних масивів і як пропустити та продовжити числові індекси у звичайних масивах, якщо нумерація починається з довільного числа.
Приклад #1 Приклад використання мовної конструкції array()
Приклад #2 Автоматична індексація при виклику конструкції array()
Результат виконання наведеного прикладу:
Array
(
[0] => 1
[1] => 1
[2] => 1
[3] => 13
[4] => 1
[8] => 1
[9] => 19
)
Зверніть увагу, що індекс «3» визначено двічі, і містить останнє значення - 13. Індекс 4 визначено після індексу 8, а наступний згенерований індекс (значення 19) - 9, оскільки найбільшим індексом був 8.
Цей приклад створює масив, нумерація якого починається з першого.
Приклад #3 Приклад створення конструкцією array() масиву, нумерація якого починається з 1
Результат виконання наведеного прикладу:
Array
(
[1] => January
[2] => February
[3] => March
)
Як і Perl, розробнику доступні значення масиву всередині подвійних лапок. Однак у PHP потрібно укласти масив у фігурні дужки.
Приклад #4 Доступ до масиву всередині подвійних лапок
Примітки
Зауваження :
array() - Конструкція мови для представлення літеральних масивів, а не проста функція.