substr_count

(PHP 4, PHP 5, PHP 7, PHP 8)

substr_count — 計(jì)算字串出現(xiàn)的次數(shù)

說明

substr_count(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?int $length = null
): int

substr_count() 返回子字符串 needle 在字符串 haystack 中出現(xiàn)的次數(shù)。注意 needle 區(qū)分大小寫。

注意:

該函數(shù)不會(huì)計(jì)算重疊字符串！參見下面的例子。

參數(shù)

haystack

在此字符串中進(jìn)行搜索。

needle

要搜索的字符串。

offset

開始計(jì)數(shù)的偏移位置。如果是負(fù)數(shù)，就從字符的末尾開始統(tǒng)計(jì)。

length

指定偏移位置之后的最大搜索長度。如果偏移量加上這個(gè)長度的和大于 haystack 的總長度，則打印警告信息。 負(fù)數(shù)的長度 length 是從 haystack 的末尾開始統(tǒng)計(jì)的。

返回值

該函數(shù)返回 int。

更新日志

版本 說明
8.0.0 length 可以為空（nullable）。
7.1.0 開始支持負(fù)數(shù)的 offset 和 length。

范例

示例 #1 substr_count() 范例

<?php
$text = 'This is a test';
echo strlen($text); // 14

echo substr_count($text, 'is'); // 2

// 字符串被簡化為 's is a test'，因此輸出 1
echo substr_count($text, 'is', 3);

// 字符串被簡化為 's i'，所以輸出 0
echo substr_count($text, 'is', 3, 3);

// 因?yàn)?nbsp;5+10 > 14，所以生成警告
echo substr_count($text, 'is', 5, 10);


// 輸出 1，因?yàn)樵摵瘮?shù)不計(jì)算重疊字符串
$text2 = 'gcdgcdgcd';
echo substr_count($text2, 'gcdgcd');
?>

參見

  • count_chars() - 返回字符串所用字符的信息
  • strpos() - 查找字符串首次出現(xiàn)的位置
  • substr() - 返回字符串的子串
  • strstr() - 查找字符串的首次出現(xiàn)