str_ireplace
str_repeat
String-Funktionen
PHP Manual

# str_pad

(PHP 4 >= 4.0.1, PHP 5)

str_pad — Erweitert 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($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_"
?>`

str_ireplace
str_repeat
String-Funktionen
PHP Manual