Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

str_pad

String-Funktionen

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


    Parameter-Liste:
NameBeschreibung
inputDie Eingabeziechenkette.
pad_lengthWenn 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ässig durch die Länge von pad_string geteilt werden kann.
pad_typeDas optionale Argument pad_type kann STR_PAD_RIGHT, STR_PAD_LEFT oder STR_PAD_BOTH sein. Wird pad_type nicht angegeben, so wird standardmässig von STR_PAD_RIGHT ausgegangen.

    Rückgabewerte:
Gibt die erweiterte Zeichenkette zurück.

    Beschreibung:
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.


    Aktiv in Version:
(PHP 4 >= 4.0.1, PHP 5)

str_pad() - Beispiel:


Eingabe:
<?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_"
?>


Beschreibung:
Mit str_pad() kann man einen String (input) auf eine bestimmte L�nge (pad_length) auff�llen, indem man einen anderen String (pad_string) oder ein Zeichen so oft wie n�tig anh�ngt. Wird pad_string nicht angegeben, so wird der String mit Leerzeichen gef�llt. Bei der Auff�llung des Strings k�nnen Sie bestimmen, nach welcher Seite (links, rechts oder beide) der String erweitert werden soll. Geben Sie keinen Wert f�r pad_type an, so wird der Default-Wert STR_PAD_RIGHT genommen. Ist die L�nge (pad_length) kleiner als die String-L�nge, so wird der Inhalt des Strings nicht ver�ndert.
String-Funktionen