String-Funktionen
PHP Manual

str_pad

(PHP 4 >= 4.0.1, PHP 5)

str_padErweitert einen String unter Verwendung eines anderen Strings auf eine bestimmte Länge

Beschreibung

string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] )

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.

Parameter-Liste

input

Die Eingabezeichenkette.

pad_length

Wenn der Wert von pad_length negativ, kürzer als oder gleich der Länge der Eingabezeichenkette ist, wird keine Erweiterung durchgeführt.

pad_string

Hinweis:

pad_string wird abgeschnitten, falls die benötigte Anzahl der zu ergänzenden Zeichen nicht gleichmäßig durch die Länge von pad_string geteilt werden kann.

pad_type

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.

Rückgabewerte

Gibt die erweiterte Zeichenkette zurück.

Beispiele

Beispiel #1 str_pad()-Beispiel

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


String-Funktionen
PHP Manual