# strstr

(PHP 4, PHP 5)

strstr — Find first occurrence of a string

### Description

string strstr ( string `$haystack` , string `$needle` , bool `$before_needle` )

Returns part of `haystack` string from 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 `needle` occurs within `haystack` , use the faster and less memory intensive function strpos() instead.

### Parameters

`haystack`

  The input string.

`needle`

  If `needle` is not a string, it is converted to an integer and applied as the ordinal value of a character.

`before_needle`

  If `TRUE` (the default is `FALSE`), strstr() returns the part of the `haystack` before the first occurence of the `needle` .

### Return Values

Returns the portion of string, or `FALSE` if `needle` is not found.

### ChangeLog

Version | Description
--- | ---
6.0.0 | Added the `before_needle` parameter.
4.3.0 | strstr() was made binary safe.

### 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

- preg_match()
- stristr()
- strpos()
- strrchr()
- substr()