strstr

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

strstr — Findet das erste Vorkommen eines Strings

Beschreibung

strstr(string $haystack, string $needle, bool $before_needle = false): string|false

Gibt den Teil der Zeichenkette haystack ab dem ersten Vorkommen (inklusive) von needle bis zum Ende von haystack zurück.

Hinweis:
Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, verwenden Sie stristr().

Hinweis:
Wenn nur es nur darum geht, festzustellen, ob ein bestimmter needle innerhalb von haystack vorkommt, sollte stattdessen die schnellere und weniger speicherintensive Funktion strpos() verwendet werden.

Parameter-Liste

haystack

Die Eingabezeichenkette.

needle

Die Zeichenkette, nach der gesucht werden soll.

Wenn der Parameter needle keine Zeichenkette ist, wird er vor PHP 8.0.0 in eine Ganzzahl umgewandelt und als ordinaler Wert eines Zeichens betrachtet. Dieses Verhalten gilt seit PHP 7.3.0 als veraltet und es wird dringend empfohlen, sich nicht darauf zu verlassen. Ist das Verhalten gewünscht, so sollte needle explizit in eine Zeichenkette umgewandelt werden oder explizit die Funktion chr() aufgerufen werden.

before_needle

Ist der Wert auf true gesetzt, gibt strstr() den Teil von haystack zurück, der sich vor dem ersten Vorkommen von needle befindet (ohne needle selbst).

Rückgabewerte

Gibt einen Teil der Zeichenkette zurück. Wird needle nicht gefunden, wird false zurückgegeben.

Changelog

Version	Beschreibung
8.0.0	`needle` akzeptiert nun eine leere Zeichenkette.
8.0.0	Die Übergabe eines Integer als `needle` wird nicht mehr unterstützt.
7.3.0	Die Übergabe eines Integer als `needle` wird missbilligt.

Beispiele

Beispiel #1 strstr()-Beispiel

<?php
$email  = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // Ausgabe: @example.com

$user = strstr($email, '@', true);
echo $user; // Ausgabe: name
?>

Siehe auch

stristr() - Wie strstr, aber unabhängig von Groß- bzw. Kleinschreibung
strrchr() - Sucht das letzte Vorkommen eines Zeichens in einem String
strpos() - Sucht die Position des ersten Vorkommens des Suchstrings in einem String
strpbrk() - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen
preg_match() - Führt eine Suche mit einem regulären Ausdruck durch

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 8 notes

down

laszlo dot heredy at gmail dot com ¶

11 years ago

strstr() is not a way to avoid type-checking with strpos().

If $needle is the last character in $haystack, and testing $needle as a boolean by itself would evaluate to false, then testing strstr() as a boolean will evaluate to false (because, if successful, strstr() returns the first occurrence of $needle along with the rest of $haystack).

<?php
findZero('01234');  // found a zero
findZero('43210');  // did not find a zero
findZero('0');      // did not find a zero
findZero('00');     // found a zero
findZero('000');    // found a zero
findZero('10');     // did not find a zero
findZero('100');    // found a zero

function findZero($numberString) {
    if (strstr($numberString, '0')) {
        echo 'found a zero';
    } else {
        echo 'did not find a zero';
    }
}
?>

Also, strstr() is far more memory-intensive than strpos(), especially with longer strings as your $haystack, so if you are not interested in the substring that strstr() returns, you shouldn't be using it anyway. 

There is no PHP function just to check only _if_ $needle occurs in $haystack; strpos() tells you if it _doesn't_ by returning false, but, if it does occur, it tells you _where_ it occurs as an integer, which is 0 (zero) if $needle is the first part of $haystack, which is why testing if (strpos($needle, $haystack)===false) is the only way to know for sure if $needle is not part of $haystack.

My advice is to start loving type checking immediately, and to familiarize yourself with the return value of the functions you are using.

Cheers.

down

Gevorg Melkumyan ¶

3 years ago

Don't confuse this function with strtr ) I lost like 1 hour on that

down

Julian Egelstaff ¶

1 year ago

Lookout for logic inversion in old code!



In PHP 8, if the needle is an empty string, this function will return 0 (not false), implying the first character of the string matches the needle. Before PHP 8, it would return false when the needle is an empty string.



There other string functions that are affected by similar issues in PHP 8: strpos(), strrpos(), stripos(), strripos(), strchr(), strrchr(), stristr(), and this function, strstr()



If you are checking if the return value === false then you will be misled by this new behaviour. You also need to check if the needle was an empty string. Basically, something like this:



<?php

$result = $needle ? strstr($haystack, $needle) : false;

?>

down

xslidian at lidian dot info ¶

11 years ago

For those in need of the last occurrence of a string:

<?php
function strrstr($h, $n, $before = false) {
    $rpos = strrpos($h, $n);
    if($rpos === false) return false;
    if($before == false) return substr($h, $rpos);
    else return substr($h, 0, $rpos);
}
?>

down

gruessle at gmail dot com ¶

13 years ago

Been using this for years:

<?php
/**
*
* @author : Dennis T Kaplan
*
* @version : 1.0
* Date : June 17, 2007
* Function : reverse strstr()
* Purpose : Returns part of haystack string from start to the first occurrence of needle
* $haystack = 'this/that/whatever';
* $result = rstrstr($haystack, '/')
* $result == this
*
* @access public
* @param string $haystack, string $needle
* @return string
**/

function rstrstr($haystack,$needle)
    {
        return substr($haystack, 0,strpos($haystack, $needle));
    }
?>

You could change it to:
rstrstr ( string $haystack , mixed $needle [, int $start] )
<?php

function rstrstr($haystack,$needle, $start=0)
    {
        return substr($haystack, $start,strpos($haystack, $needle));
    }

?>

down

w3b_monk3y at yahoo dot com ¶

15 years ago

If you want to emulate strstr's new before_needle parameter pre 5.3 strtok is faster than using strpos to find the needle and cutting with substr. The amount of difference varies with string size but strtok is always faster.

down

brett dot jr dot alton at gmail dot com ¶

16 years ago

For the needle_before (first occurance) parameter when using PHP 5.x or less, try:

<?php
$haystack = 'php-homepage-20071125.png';
$needle = '-';
$result = substr($haystack, 0, strpos($haystack, $needle)); // $result = php
?>

down

-3

trent dot renshaw at objectst dot com dot au ¶

9 years ago

> root at mantoru dot de

PHP makes this easy for you. When working with domain portion of email addresses, simply pass the return of strstr() to substr() and start at 1:

substr(strstr($haystack, '@'), 1);

＋add a note