(PHP 4, PHP 5)
array_pad — Dopełnij tablicę do podanej długości podanymi wartościami
array_pad() zwraca kopię tablicy
wejście
dopełnioną do rozmiaru określonego przez
rozmiar
wartością
wartość
. Jeśli rozmiar
jest wartością dodatnią, to tablica jest dopełniana z prawej strony,
jeśli ujemna to z lewej. Jeśli wartość bezwzględna parametru
rozmiar
jest mniejsza lub równa długości tablicy
wejście
, to tablica nie jest dopełniana.
Możliwe jest dodanie co najwyżej 1048576 elementów za jednym wywołaniem
funkcji.
wejście
Początkowa tablica, której wartości mają być dopełnione.
rozmiar
Nowy rozmiar tablicy.
wartość
Wartość, której należy użyć do dopełniania jeśli tablica
wejście
jest mniejsza niż
rozmiar
.
Zwraca kopię tablicy wejście
dopełnioną do rozmiaru
określonego przez rozmiar
wartością
wartość
. Jeśli rozmiar
jest
wartością dodatnią, to tablica jest dopełniana z prawej strony, jeśli
ujemna to z lewej. Jeśli wartość bezwzględna parametru
rozmiar
jest mniejsza lub równa długości tablicy
wejście
, to tablica nie jest dopełniana.
Przykład #1 Przykład użycia array_pad()
<?php
$wejscie = array(12, 10, 9);
$wynik = array_pad($wejscie, 5, 0);
// wynik to array(12, 10, 9, 0, 0)
$wynik = array_pad($wejscie, -7, -1);
// wynik to array(-1, -1, -1, -1, 12, 10, 9)
$wynik = array_pad($wejscie, 2, "noop");
// nie ma dopełniania
?>