Funkce array_pad

Funkce array_pad doplňuje pole určitou hodnotou na zadanou velikost. Prvním parametrem funkce přijímá pole pro vyplnění, druhým parametrem - na jakou velikost vyplnit, třetím - čím vyplnit.

Druhý parametr může být záporný - v tomto případě bude pole doplněno prvky ne na konec, ale na začátek.

Syntaxe

phparray_pad(array $array, int $length, mixed $value): array

Příklad

Doplňme pole nulami tak, aby jeho velikost byla 7 prvků:

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

Výsledek provedení kódu:

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

Příklad

Nyní má pole již 7 prvků - proto se ničím nedoplní:

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

Výsledek provedení kódu:

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

Příklad

Nastavme druhý parametr jako záporný. V tomto případě se pole doplní na začátku, ne na konci:

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

Výsledek provedení kódu:

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

Podívejte se také na

  • funkci array_fill,
    která vyplní pole zadanou hodnotou
  • funkci range,
    která vytvoří pole s rozsahem prvků