strstr
(PHP 4, PHP 5, PHP 7, PHP 8)
strstr — Find the first occurrence of a string
Description
$haystack, string $needle, bool $before_needle = false): string|false
Returns part of haystack string starting from and including the first
occurrence of needle to the end of
haystack.
Note:
This function is case-sensitive. For case-insensitive searches, use stristr().
Note:
If you only want to determine if a particular
needleoccurs withinhaystack, use the faster and less memory intensive function strpos() instead.
Parameters
-
haystack -
The input string.
-
needle -
Prior to PHP 8.0.0, if
needleis not a string, it is converted to an integer and applied as the ordinal value of a character. This behavior is deprecated as of PHP 7.3.0, and relying on it is highly discouraged. Depending on the intended behavior, theneedleshould either be explicitly cast to string, or an explicit call to chr() should be performed. -
before_needle -
If
true, strstr() returns the part of thehaystackbefore the first occurrence of theneedle(excluding the needle).
Return Values
Returns the portion of string, or false if needle
is not found.
Changelog
| Version | Description |
|---|---|
| 8.0.0 |
Passing an int as needle is no longer supported.
|
| 7.3.0 |
Passing an int as needle has been deprecated.
|
Examples
Example #1 strstr() example
<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // prints @example.com
$user = strstr($email, '@', true);
echo $user; // prints name
?>
See Also
- stristr() - Case-insensitive strstr
- strrchr() - Find the last occurrence of a character in a string
- strpos() - Find the position of the first occurrence of a substring in a string
- strpbrk() - Search a string for any of a set of characters
- preg_match() - Perform a regular expression match
