strpos

(PHP 3, PHP 4)

strpos - находит позицию первого вхождения строки.

Описание

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

Возвращает числовую позицию первого вхождения needle в строке haystack. В отличие от strrpos(), эта функция принимает полную строку как параметр needle, и вся эта строка используется.

Если needle не найден, возвращает FALSE.

Примечание: легко ошибиться с return-значениями "character found at position 0" и "character not found". Вот как определить разницу:

// в PHP 4.0b3 и новее: $pos = strpos($mystring, "b"); if ($pos === false) { // note: three equal signs // не найден ... } // в версиях до 4.0b3: $pos = strpos($mystring, "b"); if (!is_integer($pos)) { // не найден ... }

Если needle не является строкой, он конвертируется в integer и применяется как порядковое значение символа.

Необязательный параметр offset позволяет специфицировать, с какого символа в haystack начинать поиск. Эта позиция возвращается как относительная к началу haystack.

См. также strrpos(), strrchr(), substr(), stristr() и strstr().