PHP - array

Třída

Kořen \ Bez třídy

Metoda - array

(PHP 4, PHP 5, PHP 7)

Slouží pro vytvoření pole. Není ve skutečnosti funkcí, ale jazykovou konstrukcí.

Poznámka: Od PHP 5.4 je možné používat zkrácený zápis pro vytváření polí:

$pole = [];

PHP podporuje asociativní pole, což znamená, že jako klíč může být použito v podstatě cokoliv. Při vytváření pole můžeme definovat prvek i jeho klíč, nebo pouze prvek. Pokud klíč nepřiřadíme, bude automaticky přiřazen číselný index. Pro přiřazení klíče k jeho prvku slouží operátor =>. Viz ukázku.

Poznámka: Pro výpis hodnot v poli (např. pro testování) můžeme použít funkci print_r().

Procedurální

• function array (mixed $...) : array

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$...	mixed		Definice pole. Viz popis funkce nebo ukázku.

Návratové hodnoty

Vrací: array

Vrací pole s danými hodnotami. Přistup k jednotlivým prvkům pole je možný následovně:

$hodnota = $pole['nejakyKlic'];
$hodnota = $pole[0];

Příklady

Vytváření jednoduchého pole s automatickým klíčem (číselný index) + ukázka zkráceného zápisu:

<?php
$pole = array('Honza', 'Franta', 'Pepa', 'David');
print_r($pole);
$pole = ['Honza', 'Franta', 'Pepa', 'David']; // Zkrácený zápis, vytvoří stejné pole jako výše
print_r($pole);

Některé (nebo všechny) prvky v poli mohou mít definovaný klíč:

<?php
$pole = [
    'klic1' => 'prvek1',
    'klic2' => 'prvek2',
    'prvek3',
    'prvek4'
];

print_r($pole);

Jako hodnota může být definováno i další pole (o polích obsahující další pole hovoříme jako o vícerozměrných).

<?php
$pole = [
    'podpole1' => [
        'podprvek1',
        'klic2' => 'prvek2'
    ],
    [
        'podprvek2',
        'klic2' => 'prvek3'
    ]
];

print_r($pole);