Funkcja array_pad

Funkcja array_pad uzupełnia tablicę określoną wartością do zadanego rozmiaru. Pierwszym parametrem funkcja przyjmuje tablicę do wypełnienia, drugim parametrem - do jakiego rozmiaru wypełnić, trzecim - czym wypełniać.

Drugi parametr można ustawić jako ujemny - w tym przypadku tablica będzie uzupełniana elementami nie od końca, ale od początku.

Składnia

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

Przykład

Wypełnijmy tablicę zerami tak, aby jej rozmiar wynosił 7 elementów:

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

Wynik wykonania kodu:

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

Przykład

A teraz w tablicy jest już 7 elementów - więc niczym się nie wypełni:

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

Wynik wykonania kodu:

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

Przykład

Ustawmy drugi parametr jako ujemny. W tym przypadku tablica wypełni się od początku, a nie od końca:

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

Wynik wykonania kodu:

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

Zobacz też

funkcję array_fill,
która wypełnia tablicę zadaną wartością
funkcję range,
która tworzy tablicę z zakresem elementów