Function.substr

Aus PHP-Wiki

substr — Gibt einen Teil eines Strings zurück

Beschreibung

string substr ( string $string , int $start [, int $length ] )

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. 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()
• substr_replace()
• preg_match()
• trim()
• mb_substr()
• wordwrap()