(PHP 4, PHP 5, PHP 7)
array_pad — Дополнить размер массива определенным значением до заданной величины
Функция array_pad() возвращает копию массива
array
, дополненного до размера
size
элементами
со значением value
. Если параметр
size
положителен, то массив увеличивается
вправо, если отрицателен - влево. Если абсолютное значение
параметра size
меньше или равно
размеру массива array
,
функция не производит никаких операций.
За один раз возможно добавить максимум 1048576 элементов.
array
Исходный массив, к которому дополняются элементы.
size
Новый размер массива.
value
Дополняемое значение, если длина массива array
меньше size
.
Возвращает копию array
, дополненного до размера
указанного size
значением
value
. Если параметр size
положителен, то массив дополняется вправо, если он отрицателен - влево.
Если абсолютное значение size
меньше
либо равно длине array
, то дополнение не происходит.
Пример #1 Пример использования array_pad()
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// результат: array(12, 10, 9, 0, 0)
$result = array_pad($input, -7, -1);
// результат: array(-1, -1, -1, -1, 12, 10, 9)
$result = array_pad($input, 2, "noop");
// операция не произведена