iconv_strpos

FunctionParams and return types changed in PHP 8.0

Finds position of first occurrence of a needle within a haystack.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

iconv_strpos Function synopsis

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

Parameters

$haystack

Typestring

The entire string.

$needle

Typestring

The searched substring.

$offset

OptionalTypeintDefault value0

The optional $offset parameter specifies the position from which the search should be performed. If the offset is negative, it is counted from the end of the string.

$encoding

OptionalType?stringDefault valuenull

If $encoding parameter is omitted or null, $string are assumed to be encoded in iconv.internal_encoding.

Return value

Typeint|false

Returns the numeric position of the first occurrence of $needle in $haystack.

If $needle is not found, iconv_strpos will return false.

Changes to the iconv_strpos Function

PHP 8.0

  • Return type added: int|false
  • Parameter type added for parameter #1 ($haystack): string
  • Parameter type added for parameter #2 ($needle): string
  • Parameter type added for parameter #3 ($offset): int
  • Parameter default value added for position #3 ($offset): 0
  • Parameter name of parameter #4 changed: $charset to $encoding
  • Parameter type added for parameter #4 ($encoding): ?string
  • Parameter default value added for position #4 ($encoding): null
  iconv_strpos(
-     $haystack,
+     string $haystack,
-     $needle,
+     string $needle,
-     $offset,
+     int $offset = 0,
-     $charset
+     ?string $encoding = null
-   )
+   ): int|false

iconv_strpos Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes