PHP Dokumentation: Function substr
12. Januar 2010 von werner
substr
(PHP 4, PHP 5)
substr — Gibt einen Teil eines Strings zurück
Beschreibung
Gibt den Teil von string zurück, der durch die Parameter start und length definiert wurde.
Parameter-Liste
- string
Die Eingabezeichenkette.
- start
Wenn start nicht negativ ist, beginnt der zurückgegebene 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.
Ist start negativ, beginnt der zurückgegebene String bei dem in start festgelegten Zeichen vom Ende von string aus betrachtet.
Ist string kürzer als oder gleich start Zeichen, wird FALSE zurückgegeben.
Beispiel #1 Einen negativen start-Wert 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
?>- length
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 length angegeben und negativ, werden genau so viele Zeichen vom Ende von string abgeschnitten (nachdem die Startposition ermittelt wurde, sollte start negativ sein). Gibt start eine Position hinter dem abzuschneidenden Teil an, wird ein leerer String zurückgegeben.
Wenn length gegeben ist und den Wert 0, FALSE oder NULL hat, wird ein leerer String zurückgegeben.
Beispiel #2 Negativen length-Wert 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
?>
Rückgabewerte
Gibt den extrahierten Teil der Zeichenkette zurück.
Beispiele
Beispiel #3 Generelle Verwendung von substr()
<?php
echo substr('abcdef', 1); // bcdef
echo substr('abcdef', 1, 3); // bcd
echo substr('abcdef', 0, 4); // abcd
echo substr('abcdef', 0, 8); // abcdef
echo substr('abcdef', -1, 1); // f// Auf ein einzelnes Zeichen eines Strings kann auch mittels
// eckiger Klammern zugegriffen werden
$string = 'abcdef';
echo $string[0]; // a
echo $string[3]; // d
echo $string[strlen($string)-1]; // f?>Siehe auch
- strrchr() – Sucht das letzte Vorkommen eines Zeichens in einem String
- substr_replace() – Ersetzt Text innerhalb einer Zeichenkette
- preg_match() – Führt eine Suche mit einem regulären Ausdruck durch
- trim() – Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings
- mb_substr() – Get part of string
- wordwrap() – Bricht einen String nach einer bestimmten Anzahl Zeichen um
Loading ...