array_pad

(PHP 4, PHP 5, PHP 7)

array_padComplète un tableau avec une valeur jusqu'à la longueur spécifiée

Description

array_pad ( array $array , int $size , mixed $value ) : array

array_pad() retourne une copie du tableau array complétée jusqu'à la taille de size avec la valeur value. Si size est positif, alors le tableau est complété à droite, s'il est négatif, il est complété à gauche. Si la valeur absolue de size est plus petite que la taille du tableau array, alors le tableau n'est pas complété. Il est possible d'ajouter au maximum 1048576 éléments d'un seul coup.

Liste de paramètres

array

Tableau initial de valeurs à compléter.

size

Nouvelle taille du tableau.

value

Valeur à insérer si l'argument array est plus petit que l'argument size.

Valeurs de retour

Retourne une copie du tableau array complétée jusqu'à la taille de size avec la valeur value. Si size est positif, alors le tableau est complété à droite, s'il est négatif, il est complété à gauche. Si la valeur absolue de size est plus petite que la taille du tableau array, alors le tableau n'est pas complété.

Exemples

Exemple #1 Exemple avec array_pad()

<?php
$input 
= array(12109);

$result array_pad($input50);
// Le résultat est : array(12, 10, 9, 0, 0)

$result array_pad($input, -7, -1);
// Le résultat est : array(-1, -1, -1, -1, 12, 10, 9)

$result array_pad($input2"noop");
// pas complété
?>

Voir aussi

  • array_fill() - Remplit un tableau avec une même valeur
  • range() - Crée un tableau contenant un intervalle d'éléments