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