(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
str_pad — Complète une chaîne jusqu'à une taille donnée
$string,$length,$pad_string = " ",$pad_type = STR_PAD_RIGHT
Retourne la chaîne string,
complétée à droite, à gauche ou dans les deux sens, avec la
chaîne pad_string jusqu'à ce qu'elle
atteigne la taille de length.
stringLa chaîne d'entrée.
length
La longueur souhaitée de la chaîne finale complétée.
Si la valeur de length est négative, plus petite
que, ou égale à la taille courante de la chaîne string,
string est retournée inchangée et
string 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"
?>