php8.5
Home/ Manual/ mbstring / functions/ mb_stripos

mb_stripos

PHP function Edit on GitHub ✎

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

Finds position of first occurrence of a string within another, case insensitive

Description

mb_stripos(string $haystack, string $needle, int $offset = 0, string|null $encoding = null): int|false

mb_stripos() returns the numeric position of the first occurrence of needle in the haystack string. Unlike mb_strpos(), mb_stripos() is case-insensitive. If needle is not found, it returns false.

Parameters

haystack

The string from which to get the position of the first occurrence of needle

needle

The string to find in haystack

offset

The position in haystack to start searching. A negative offset counts from the end of the string.

encoding

Parameter

Return Values

Return the numeric position of the first occurrence of needle in the haystack string, or false if needle is not found.

Errors/Exceptions

  • If offset is greater than the length of haystack, a ValueError will be thrown.

Changelog

VersionDescription
7.1.0Support for negative offsets has been added.

See Also

Source: reference/mbstring/functions/mb-stripos.xml · from the official PHP manual (php/doc-en)