Funkce array_pad

Funkce array_pad doplňuje pole určitou hodnotou na zadanou velikost. Prvním parametrem funkce přijímá pole pro vyplnění, druhým parametrem - na jakou velikost vyplnit, třetím - čím vyplnit.

Druhý parametr může být záporný - v tomto případě bude pole doplněno prvky ne na konec, ale na začátek.

Syntaxe

array_pad(array $array, int $length, mixed $value): array

Příklad

Doplňme pole nulami tak, aby jeho velikost byla 7 prvků:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_pad($arr, 7, 0);
	var_dump($res);
?>

Výsledek provedení kódu:

['a', 'b', 'c', 'd', 'e', 0, 0]

Příklad

Nyní má pole již 7 prvků - proto se ničím nedoplní:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e', 'f', 'g'];
	
	$res = array_pad($arr, 7, 0);
	var_dump($res);
?>

Výsledek provedení kódu:

['a', 'b', 'c', 'd', 'e', 'f', 'g']

Příklad

Nastavme druhý parametr jako záporný. V tomto případě se pole doplní na začátku, ne na konci:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_pad($arr, -7, 0);
	var_dump($res);
?>

Výsledek provedení kódu:

[0, 0, 'a', 'b', 'c', 'd', 'e']

Podívejte se také na

funkci array_fill,
která vyplní pole zadanou hodnotou
funkci range,
která vytvoří pole s rozsahem prvků