PHP Handbuch
Zurück |  | Weiter

# 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ück | Zum Anfang | Weiter
str_ireplace | Nach oben | str_repeat