Konstrukcja językowa PHP array() służy do tworzenia tablicy: indeksowanej numerycznie, asocjacyjnej lub wielowymiarowej. Szczegółowy opis tych struktur danych znajduje się w rozdziale Tablice PHP.
array() często bywa nazywana funkcją, w rzeczywistości jest konstrukcją języka PHP, służącą do tworzenia literałów tablicowych.Składnia konstrukcji PHP array()
Konstrukcja PHP array() ma dwie składnie, jedną do tworzenia tablic indeksowanych numerycznie, a drugą – do tworzenia tablic asocjacyjnych.
Składnia do tworzenia tablic indeksowanych numerycznie:
array(mixed wartość1, mixed wartość2, mixed wartość3, ...)
Składnia do tworzenia tablic asocjacyjnych:
array(string/int klucz1 => mixed wartość1, string/int klucz2 => mixed wartość2, string/int klucz3 => mixed wartość3, ...)
Parametry
| Parametr | Opis |
|---|---|
klucz |
Klucz elementu tablicy asocjacyjnej, może być liczbą całkowitą lub łańcuchem znaków. Jeśli zostanie pominięty, to automatycznie zostanie wygenerowany indeks numeryczny, zaczynając od |
wartość |
Wartość elementu tablicy. Może być dowolnego z następujących typów: object, |
Wartość zwrotna
Konstrukcja PHP array() zwraca tablicę utworzoną z przekazanych jej argumentów. W zależności od tego, jakie przekazano argumenty, tablica może być indeksowana numerycznie, asocjacyjna lub wielowymiarowa.
Typ zwrotny: tablica.
Dodatkowe przykłady
Poniżej znajduje się kilka dodatkowych przykładów użycia konstrukcji PHP array() do tworzenia i przeglądania różnych rodzajów tablic.
Przykład tablicy asocjacyjnej
Poniższy kod tworzy tablicę asocjacyjną o nazwie $owady i wyświetla jeden z jej elementów na stronie:
$owady = array("turkuć" => "podjadek",
"zyzuś" => "tłuścioch",
"złodziejaszek" => "rypidełko",
"wydłubka" => "oczateczka",);
echo "Pełna nazwa turkucia to „turkuć $owady[turkuć]”.";Przykład tablicy wielowymiarowej
Aby utworzyć tablicę wielowymiarową za pomocą konstrukcji językowej PHP array(), należy zdefiniować tablice jako wartości elementów innej tablicy.
$pokarm = array (
"turkuć" => array("kapusta", "ziarno"),
"zyzuś" => array("owady", "bezkręgowce"),
"wydłubka" => array("kwiaty", "owoce")
);
echo $pokarm["turkuć"][1];
echo $pokarm["zyzuś"][0];W tym przykładzie została utworzona asocjacyjna tablica dwuwymiarowa o nazwie $pokarm, która jako wartości elementów zawiera trzy tablice jednowymiarowe indeksowane numerycznie.
Przeglądanie tablicy za pomocą pętli for
Pętla PHP for świetnie nadaje się do przeglądania tablic indeksowanych numerycznie.
$owady = array("turkuć podjadek", "zyzuś tłuścioch", "złodziejaszek rypidełko", "wydłubka oczateczka");
$length = count($owady);
for ($i = 0; $i < $length; $i++) {
echo $owady[$i], "<br>";
}Przeglądanie tablicy za pomocą pętli foreach
Pętla PHP foreach jest przeznaczona do przeglądania tablic zarówno tablic indeksowanych numerycznie, jak i asocjacyjnych, przy czym największe korzyści daje w przypadku tych drugich.
$owady = array("turkuć" => "podjadek",
"zyzuś" => "tłuścioch",
"złodziejaszek" => "rypidełko",
"wydłubka" => "oczateczka",);
echo "W polsce mamy owady o pięknie brzmiących nazwach:<br>";
foreach($owady as $klucz => $wartość) {
echo $klucz, " ", $wartość, "<br>";
}Tablica asocjacyjna z pominiętym kluczem
Poniżej znajduje się przykładowa tablica asocjacyjna z pominiętym kluczem.
$tablica = array("klucz1"=>"wartosć1", "klucz2"=>"wartosć2", "wartość3");
echo $tablica[0]; // Wynik: wartość3
