array_pad

(PHP 4, PHP 5)

array_pad — Дополнить размер массива определенным значением до заданной величины

Описание

array array_pad ( array $input , int $pad_size , mixed $pad_value )

Функция array_pad() возвращает копию массива input, дополненного до размера pad_size элементами со значением pad_value. Если параметр pad_size положителен, то массив увеличивается вправо, если отрицателен - влево. Если абсолютное значение параметра pad_size меньше или равно размеру массива input, функция не производит никаких операций. За один раз возможно добавить максимум 1048576 элементов.

Список параметров

input: Исходный массив, к которому дополняются элементы.
pad_size: Новый размер массива.
pad_value: Дополняемое значение, если длина массива input меньше pad_size.

Возвращаемые значения

Возвращает копию input, дополненного до размера указанного pad_size значением pad_value. Если параметр pad_size положителен, то массив дополняется вправо, если он отрицателен - влево. Если абсолютное значение pad_size меньше либо равно длине input, то дополнение не происходит.

Примеры

Пример #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() - Создает массив, содержащий диапазон элементов