PHP str_pad()

La fonction str_pad() est une fonction intégrée en PHP et est utilisée pour compléter une chaîne à une longueur donnée. Nous pouvons compléter la chaîne en argument par n’importe quelle autre chaîne jusqu’à une longueur spécifiée. Si nous ne transmettons pas d’autre chaîne à la fonction str_pad(), la chaîne en argument sera complétée par des espaces.
 

Syntaxe

str_pad(str, length, pad_str, type)

 
 

Paramètres

• str(Obligatoire) : Spécifie la chaîne à compléter.
• length(Obligatoire) : Spécifie la longueur du nouvelle chaîne. Si cette valeur est inférieure à la longueur de la chaîne origine, rien ne sera appliqué.
• pad_str(Optionnelle) : Spécifie la chaîne à utiliser pour le remplissage. La valeur par défaut est un espace " ".
• type(Optionnelle) : Il spécifie le côté de la chaîne à remplir, c’est-à-dire à gauche, à droite ou les deux. Par défaut, sa valeur est définie sur « STR_PAD_RIGHT ». Si on veut remplir le côté gauche, nous devons définir ce paramètre sur « STR_PAD_LEFT » et si on veut remplir les deux côtés, ce paramètre doit être défini sur « STR_PAD_BOTH ».

 

Valeur de retour

La fonction renvoie une nouvelle chaîne obtenue après le remplissage de la chaîne d’entrée $str.
 

Version PHP:

4.0.1+
 

Exemple 1:

Le code suivant remplisse le côté droit, avec une nouvelle longueur de 30 caractères:

<?php
	$str = "Hello World";
	echo str_pad($str,30,".");
?>

 
Sortie:

Hello World...................

 

Exemple 2:

Le code suivant remplisse le côté gauche, avec une nouvelle longueur de 30 caractères:

<?php
	$str = "Hello World";
	echo str_pad($str,30,".",STR_PAD_LEFT);
?>

 
Sortie:

...................Hello World