(PHP 4 >= 4.0.1, PHP 5, PHP 7)
str_pad — Complète une chaîne jusqu'à une taille donnée
$input
, int $pad_length
[, string $pad_string = " "
[, int $pad_type = STR_PAD_RIGHT
]] ) : string
Retourne la chaîne input,
complétée à droite, à gauche ou dans les deux sens, avec la
chaîne pad_string jusqu'à ce qu'elle
atteigne la taille de pad_length.
inputLa chaîne d'entrée.
pad_length
Si la valeur de pad_length est négative, plus petite
que, ou égale à la taille courante de la chaîne input,
input est retournée inchangée et
input sera retourné.
pad_stringNote:
Le paramètre
pad_stringpeut être tronqué si le nombre de caractères de complétion n'est pas multiple de la taille depad_string.
pad_type
L'argument optionnel pad_type peut être
l'une des constantes suivantes : STR_PAD_RIGHT,
STR_PAD_LEFT, ou STR_PAD_BOTH.
Si pad_type n'est pas spécifié, il
prend la valeur par défaut de STR_PAD_RIGHT.
Retourne la chaîne complétée.
Exemple #1 Exemple avec str_pad()
<?php
$input = "Alien";
echo str_pad($input, 10); // produces "Alien "
echo str_pad($input, 10, "-=", STR_PAD_LEFT); // produces "-=-=-Alien"
echo str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Alien___"
echo str_pad($input, 6, "___"); // produces "Alien_"
echo str_pad($input, 3, "*"); // produces "Alien"
?>