PHP Manual
Prev |  | Next

# strpos

strpos -- Find position of first occurrence of a string.

## Description

`int strpos`(string haystack, string needle, int [offset] );

Returns the numeric position of the first occurrence of `needle` in the `haystack` string. Unlike the strrpos(), this function can take a full string as the `needle` parameter and the entire string will be used.

If `needle` is not found, returns false.

> Note: It is easy to mistake the return values for "character found at position 0" and "character not found". Here's how to detect the difference:

>       1
>       2 // in PHP 4.0b3 and newer:
>       3 $pos = strpos ("b", $mystring);
>       4 if ($pos === false) { // note: three equal signs
>       5     // not found...
>       6 }
>       7
>       8 // in versions older than 4.0b3:
>       9 $pos = strpos ("b", $mystring);
>      10 if (is_string ($pos) && !$pos) {
>      11     // not found...
>      12 }
>      13

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

The optional `offset` parameter allows you to specify which character in `haystack` to start searching. The position returned is still relative to the the beginning of `haystack`.

See also strrpos(), strrchr(), substr(), stristr(), and strstr().

Prev | Home | Next
strlen | Up | strrchr