array_pad

(PHP 4, PHP 5)

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

Description

array array_pad ( array $input , int $pad_size , mixed $pad_value )

array_pad() retourne une copie du tableau input complétée jusqu'à la taille de pad_size avec la valeur pad_value. Si pad_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 pad_size est plus petite que la taille du tableau input, 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

input: Tableau initial de valeurs à compléter.
pad_size: Nouvelle taille du tableau.
pad_value: Valeur à insérer si l'argument input est plus petit que l'argument pad_size.

Valeurs de retour

Retourne une copie du tableau input complétée jusqu'à la taille de pad_size avec la valeur pad_value. Si pad_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 pad_size est plus petite que la taille du tableau input, 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

array_multisort

Fonctions sur les tableaux

array_pop

Manuel PHP