# Функция array_pad

Функция `array_pad` дополняет массив определенным значением до заданного размера. Первым параметром функция принимает массив для заполнения, вторым параметром - до какого размера заполнить, третьим - чем заполнять.

Второй параметр можно делать отрицательным - в этом случае массив будет дополнятся элементами не с конца, а с начала.

## Синтаксис

`array_pad(массив, до какого размера заполнить, чем заполнять);`

## Пример

Давайте заполним массив нулями так, чтобы его размер стал `7` элементов:

`<?php $arr = ['a', 'b', 'c', 'd', 'e']; $result = array_pad($arr, 7, 0); var_dump($result); ?>`

Результат выполнения кода:

`['a', 'b', 'c', 'd', 'e', 0, 0]`

## Пример

А теперь в массиве уже есть `7` элементов - поэтому он ничем не заполнится:

`<?php $arr = ['a', 'b', 'c', 'd', 'e', 'f', 'g']; $result = array_pad($arr, 7, 0); var_dump($result); ?>`

Результат выполнения кода:

`['a', 'b', 'c', 'd', 'e', 'f', 'g']`

## Пример

Давайте второй параметр сделаем отрицательным. В этом случае массив заполнится сначала, а не с конца:

`<?php $arr = ['a', 'b', 'c', 'd', 'e']; $result = array_pad($arr, -7, 0); var_dump($result); ?>`

Результат выполнения кода:

`[0, 0, 'a', 'b', 'c', 'd', 'e']`

## Смотрите также

- функцию `array_fill`,
  которая заполняет массив заданным значением
- функцию `range`,
  которая создает массив с диапазоном элементов

←→
↑