PHP Handbuch
ZurückWeiter

str_pad

(PHP 4 >= 4.0.1, PHP 5)

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]] )

Die Funktion gibt den input-String, erweitert auf der linken, rechten oder auf beiden Seiten um die angegebene Länge, zurück. Wenn das optionale Argument pad_string nicht angegeben ist, wird input durch Leerzeichen erweitert, anderenfalls bis zum Ende durch die in pad_string angegebenen Zeichen.

Das optionale Argument pad_type kann STR_PAD_RIGHT, STR_PAD_LEFT oder STR_PAD_BOTH sein. Wird pad_type nicht angegeben, so wird standardmäßig 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

<?php
$input = "Alien";
echo str_pad($input, 10);                      // ergibt "Alien     "
echo str_pad($input, 10, "-=", STR_PAD_LEFT);  // ergibt "-=-=-Alien"
echo str_pad($input, 10, "_", STR_PAD_BOTH);   // ergibt "__Alien___"
echo str_pad($input, 6 , "___");               // ergibt "Alien_"
?>

Anmerkung: pad_string kann abgeschnitten werden, wenn die erforderliche Anzahl der erweiternden Zeichen aufgrund der Länge von pad_string nicht in zwei gleiche Teile geteilt werden kann.

ZurückZum AnfangWeiter
str_ireplaceNach obenstr_repeat