substr
(PHP 3, PHP 4 , PHP 5)
substr -- Gibt einen Teil eines Strings zurück
Beschreibung:
string
substr ( string string, int start [, int length])
substr() gibt den Teil von
string zurück, der durch die Parameter
start und length
definiert wurde.
Wenn start positiv ist, beginnt der zurück
gegebene String an der start-Position von
string, angefangen bei NULL. So ist z.B. im
String 'abcdef' das Zeichen an der Position
0 gleich 'a', das Zeichen an
der Position 2 ist 'c' usw.
Beispiel 1. Generelle Verwendung von substr()
<?php
$rest = substr("abcdef", 1); // gibt "bcdef" zurück
$rest = substr("abcdef", 1, 3); // gibt "bcd" zurück
$rest = substr("abcdef", 0, 4); // gibt "abcd" zurück
$rest = substr("abcdef", 0, 8); // gibt "abcdef" zurück
// Der Zugriff mittels geschwungenen Klammer ist eine
// weitere Möglickeit
$string = 'abcdef';
echo $string{0}; // gibt a zurück
echo $string{3}; // gibt d zurück
?>
|
|
Ist start negativ, beginnt der zurückgegebene
String bei dem start'en Zeichen vom Ende von
string.
Beispiel 2. Negativen start verwenden
<?php
$rest = substr("abcdef", -1); // gibt "f" zurück
$rest = substr("abcdef", -2); // gibt "ef" zurück
$rest = substr("abcdef", -3, 1); // gibt "d" zurück
?>
|
|
Ist length angegeben und positiv, enthält der
zurückgegebene String höchstens length Zeichen
ab start (abhängig von der Länge von
string). Ist string
kürzer als start Zeichen, wird FALSE
zurückgegeben.
Ist length angegeben und negativ, dann werden
genauso viele Zeichen vom Ende von string
abgeschnitten (nachdem die Starposition ermittelt wurde, sollte
start negativ sein). Gibt
start eine Position hinter dem abzuschneidenden
Teil an, wird ein leerer String zurückgegeben.
Beispiel 3. Negative length verwenden
<?php
$rest = substr("abcdef", 0, -1); // gibt "abcde" zurück
$rest = substr("abcdef", 2, -1); // gibt "cde" zurück
$rest = substr("abcdef", 4, -4); // gibt "" zurück
$rest = substr("abcdef", -3, -1); // gibt "de" zurück
?>
|
|
Siehe auch strrchr() und
ereg().