array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.array-pad.php', 1 => 'array_pad', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.array-multisort.php', 1 => 'array_multisort', ), 'next' => array ( 0 => 'function.array-pop.php', 1 => 'array_pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/array-pad.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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");
// Операция не выполнена