array_pad
(PHP 4, PHP 5, PHP 7)
array_pad — Дополнить массив определенным значением до указанной длины
Описание
Функция array_pad() возвращает копию массива
array, дополненного до размера
length элементами
со значением value. Если параметр
length положителен, то массив увеличивается
вправо, если отрицателен - влево. Если абсолютное значение
параметра length меньше или равно
размеру массива array,
функция не производит никаких операций.
За один раз возможно добавить максимум 1048576 элементов.
Список параметров
-
array -
Исходный массив, к которому дополняются элементы.
-
length -
Новый размер массива.
-
value -
Дополняемое значение, если длина массива
arrayменьшеlength.
Возвращаемые значения
Возвращает копию array, дополненного до размера
указанного length значением
value. Если параметр length
положителен, то массив дополняется вправо, если он отрицателен - влево.
Если абсолютное значение length меньше
либо равно длине 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");
// операция не произведена
Смотрите также
- array_fill() - Заполняет массив значениями
- range() - Создает массив, содержащий диапазон элементов