(PHP 4 >= 4.0.1, PHP 5)
str_pad — Erweitert einen String unter Verwendung eines anderen Strings auf eine bestimmte Länge
$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.
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_stringwird abgeschnitten, falls die benötigte Anzahl der zu ergänzenden Zeichen nicht gleichmäßig durch die Länge vonpad_stringgeteilt 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.
Gibt die erweiterte Zeichenkette zurück.
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_"
?>