substr_count
PHP 4, PHP 5, PHP 7, PHP 8
substr_count - Count the number of substring occurrences
substr_count(
string$haystack,
string$needle,
[int$offset = 0],
[int|null$length = null]
): int
string$haystack,
string$needle,
[int$offset = 0],
[int|null$length = null]
): int
substr_count returns the number of times the needle substring occurs in the haystack string. Please note that needle is case sensitive.
Note:
This function doesn't count overlapped substrings. See the example below!
Parameters
- haystack
-
The string to search in
- needle
-
The substring to search for
- offset
-
The offset where to start counting. If the offset is negative, counting starts from the end of the string.
- length
-
The maximum length after the specified offset to search for the substring. It outputs a warning if the offset plus the length is greater than the haystack length. A negative length counts from the end of haystack.
Return Values
This function returns an int.
Changelog
| Version | Description |
| 8.0.0 | length is nullable now. |
| 7.1.0 | Support for negative offsets and lengths has been added. length may also be 0 now. |