str_pad

(PHP 4 >= 4.0.1)

str_pad --  Erweitert einen String auf eine bestimmte Länge unter Verwendung eines anderen Strings

Beschreibung:

string str_pad ( string input, int pad_length [, string pad_string [, int pad_type]])

Mit dieser Funktion erweitern Sie den String input auf der linken, rechten oder beiden Seiten auf die mit dem optionalen Parameter pad_type angegebene Länge. Wird das optionale Argument pad_string nicht angegeben, erfolgt die Erweiterung mit Leerzeichen, ansonsten wird hierzu der Inhalt von pad_string verwendet.

Das optionale Argument pad_type kann STR_PAD_RIGHT, STR_PAD_LEFT oder STR_PAD_BOTH sein. Wird pad_type nicht angegeben, so wird per default von STR_PAD_RIGHT ausgegangen.

Ist der Wert von pad_length negativ oder kleiner als die Länge des Input-Strings, wird keine Erweiterung vorgenommen.

Beispiel 1. str_pad()-Beispiel:

$input = "Alien";
print str_pad ($input, 10);                     // Ergebnis "Alien     "
print str_pad ($input, 10, "-=", STR_PAD_LEFT); // Ergebnis "-=-=-Alien"
print str_pad ($input, 10, "_", STR_PAD_BOTH);  // Ergebnis "__Alien___"