(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)
$result = array_pad($input, -7, -1);
// Результат: array(-1, -1, -1, -1, 12, 10, 9)
$result = array_pad($input, 2, "noop");
// Операция не выполнена