array_pad
(PHP 4, PHP 5)
array_pad — Complète un tableau avec une valeur jusqu'à la longueur spécifiée
Description
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
arrayest plus petit que l'argumentsize.
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(12, 10, 9);
$result = array_pad($input, 5, 0);
// 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($input, 2, "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