PHP Handbuch
Zurück |  | Nach vorne

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

Zurück | Zum Anfang | Nach vorne
substr_replace | Nach oben | trim