substr

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 0 (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().