substr

(PHP 4, PHP 5, PHP 7, PHP 8)

substrLiefert einen Teil eines Strings

Beschreibung

substr(string $string, int $offset, ?int $length = null): string

Gibt den Teil von string zurück, der durch die Parameter offset und length definiert wurde.

Parameter-Liste

string

Der Eingabestring.

offset

Wenn offset nicht negativ ist, beginnt der zurückgegebene String an der offset-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 offset negativ, beginnt der zurückgegebene String bei dem in offset festgelegten Zeichen vom Ende von string aus betrachtet.

Ist string kürzer als offset Zeichen, wird ein leerer String zurückgegeben.

Beispiel #1 Einen negativen offset-Wert verwenden

<?php
$rest 
substr("abcdef", -1);    // gibt "f" zurück
$rest substr("abcdef", -2);    // gibt "ef" zurück
$rest substr("abcdef", -31); // gibt "d" zurück
?>

length

Ist length angegeben und positiv, enthält der zurückgegebene String höchstens length Zeichen ab offset (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, wenn offset negativ ist). Gibt offset die Position der Abtrennung oder dahinter an, wird ein leerer String zurückgegeben.

Wenn length gegeben ist und den Wert 0 hat, wird ein leerer String zurückgegeben.

Wenn length ausgelassen wird oder null ist, wird der Teilstring beginnend von offset bis zum Ende des Strings 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; vor PHP 8.0.0 wurde false zurückgegeben
$rest substr("abcdef", -3, -1); // gibt "de" zurück
?>

Rückgabewerte

Gibt den extrahierten Teil von string oder einen leeren String zurück.

Changelog

Version Beschreibung
8.0.0 length ist jetzt nullable (akzeptiert den null-Wert). Wenn length explizit auf null gesetzt wird, gibt die Funktion einen Teilstring zurück, der am Ende des Strings endet, während sie vorher einen leeren String zurückgegeben hat.
8.0.0 Die Funktion gibt einen leeren String zurück, wo sie vorher false zurückgegeben hat.

Beispiele

Beispiel #3 Generelle Verwendung von substr()

<?php
echo substr('abcdef'1);     // bcdef
echo substr("abcdef"1null); // bcdef; vor PHP 8.0.0 wurde ein leerer String zurückgegeben
echo substr('abcdef'13);  // bcd
echo substr('abcdef'04);  // abcd
echo substr('abcdef'08);  // abcdef
echo substr('abcdef', -11); // 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

?>

Beispiel #4 substr()-Typumwandlungs-Verhalten

<?php
class apple {
    public function 
__toString() {
        return 
"green";
    }
}

echo 
"1) ".var_export(substr("pear"02), true).PHP_EOL;
echo 
"2) ".var_export(substr(5432102), true).PHP_EOL;
echo 
"3) ".var_export(substr(new apple(), 02), true).PHP_EOL;
echo 
"4) ".var_export(substr(true01), true).PHP_EOL;
echo 
"5) ".var_export(substr(false01), true).PHP_EOL;
echo 
"6) ".var_export(substr(""01), true).PHP_EOL;
echo 
"7) ".var_export(substr(1.2e304), true).PHP_EOL;
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

1) 'pe'
2) '54'
3) 'gr'
4) '1'
5) ''
6) ''
7) '1200'

Beispiel #5 Ungültiger Zeichenbereich

Wenn ein ungültiger Zeichenbereich angefordert wird, gibt substr() seit PHP 8.0.0 einen leeren String zurück; vorher wurde stattdessen false zurückgegeben.

<?php
var_dump
(substr('a'2));
?>

Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:

string(0) ""
]

Das oben gezeigte Beispiel erzeugt folgende Ausgabe mit PHP 7:

bool(false)

Siehe auch

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Neuigkeiten für PHP-Entwickler: Laravel 11 Veröffentlichung

Am 12. März 2024 wurde die lang erwartete Version 11 des Laravel-Frameworks veröffentlicht, die eine Reihe von spannenden Neuerungen und Verbesserungen für die PHP-Entwicklungsgemeinschaft mit sich bringt. ...

Mike94

Autor : Mike94
Kategorie: PHP Magazin

Technisches SEO bleibt relevant

Technisches SEO – Was ist das überhaupt? Technisches SEO bezieht sich auf die Optimierung der technischen Aspekte deiner Webseite. Das Ziel ist klar! ...

admin

Autor : admin
Kategorie: SEO & Online-Marketing

Was ist neu in der PHP 8.2.10

PHP 8.2.10 ist eine der neuesten Versionen von PHP, die eine Reihe von Verbesserungen und neuen Funktionen mit sich bringt. In diesem Artikel werden wir einige der herausragenden Neuerungen und Verbesserungen dieser Version diskutieren. ...

admin

Autor : admin
Kategorie: Software-Updates

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Seltsames Verhalten von execute() oder Fehler meinerseits

Hallo liebe Community, ich habe ein kleines Problem und vielleicht kann mir ja jemand helfen, würde ich mich sehr drüber freuen. Unten steht e ...

Geschrieben von garibaldiwz am 22.03.2024 13:03:12
Forum: SQL / Datenbanken
Google reCAPTCHA in Kontaktformular einbinden

Überprüfen Sie den E-Mail-Versand: Stellen Sie sicher, dass die E-Mail-Funktion mail() ordnungsgemäß funktioniert und dass keine Fehler beim V ...

Geschrieben von Gast am 18.03.2024 04:54:16
Forum: PHP Developer Forum
`count.php`

Hallo cober93327, und Danke fuer deine Antwort! :-) Naja, so einen "Besucherzähler" auf der Webseite anzuzeigen ist schon eher etwas, das man a ...

Geschrieben von kekse1 am 17.03.2024 15:56:38
Forum: Projekthilfe
`count.php`

Es gibt dazu natuerlich auch eine recht ausfuehrliche Dokumentation in meinem GitHub-Repository Es würde meiner Ansicht nach enorm helfen, wenn D ...

Geschrieben von cober93327 am 14.03.2024 15:49:28
Forum: Projekthilfe