mb_substr_count遇到空字符串會返回什麼？結果解析和注意事項

gitbox 2025-09-02

在PHP中， mb_substr_count函數用於計算一個字符串中另一個子字符串出現的次數。該函數是多字節字符串擴展（mbstring）的一部分，專門用於處理包含多字節字符（如UTF-8編碼）的字符串。與substr_count不同， mb_substr_count在處理多字節字符時，能夠正確地計算字符出現的次數。

然而，當我們在使用mb_substr_count時，傳入空字符串作為參數，究竟會返回什麼結果呢？本文將深入分析mb_substr_count函數遇到空字符串時的行為，並提供一些注意事項。

mb_substr_count函數的基本使用

mb_substr_count的函數原型如下：

 <span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-title function_ invoke__">mb_substr_count</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$needle</span></span><span>, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$encoding</span></span><span> = </span><span><span class="hljs-literal">null</span></span><span>);
</span></span>

$haystack ：被搜索的目標字符串。
$needle ：要在目標字符串中查找的子字符串。
$encoding ：可選參數，指定字符編碼。默認使用內部字符編碼。

該函數返回**$needle在$haystack**中出現的次數。

1. mb_substr_count遇到空字符串作為子字符串時的行為

假設我們向mb_substr_count函數傳遞了一個空字符串作為子字符串（即$needle ），根據PHP文檔，返回值將是目標字符串中包含的子字符串出現次數。

示例1：空子字符串作為needle

 <span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, world!"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">""</span></span><span>;
</span><span><span class="hljs-variable">$count</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_substr_count</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$count</span></span><span>;  </span><span><span class="hljs-comment">// 輸出：0</span></span><span>
</span></span>

在上面的代碼中， $needle是一個空字符串，儘管目標字符串$haystack並不為空，但PHP會將空字符串看作是“沒有出現過的子字符串”。因此，函數返回0。

2. 空目標字符串作為haystack時的行為

如果傳遞給mb_substr_count的目標字符串$haystack為空字符串（即$haystack = "" ），無論$needle是什麼，返回值都會是0。因為空字符串中無法包含任何子字符串，無論該子字符串是什麼。

示例2：空目標字符串作為haystack

 <span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">""</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"Hello"</span></span><span>;
</span><span><span class="hljs-variable">$count</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_substr_count</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$count</span></span><span>;  </span><span><span class="hljs-comment">// 輸出：0</span></span><span>
</span></span>

這裡，儘管$needle為“Hello”，空字符串$haystack不包含任何內容，所以返回0。

3. 空字符串的特殊情況總結

通過上面的兩個示例可以看出， mb_substr_count對於空字符串的行為是符合直覺的：

如果子字符串為空，則返回0，因為沒有子字符串可以被匹配。
如果目標字符串為空，則返回0，因為空字符串中無法包含任何子字符串。

這兩個情況是mb_substr_count函數中比較常見的“邊界情況”，在使用時需要注意。

4. 性能考量

雖然空字符串的行為在大多數情況下沒有問題，但為了提高代碼的可讀性和效率，建議避免將空字符串作為參數傳遞給mb_substr_count 。如果$needle是一個空字符串，建議在調用mb_substr_count之前進行簡單的檢查，例如：

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$needle</span></span><span> !== </span><span><span class="hljs-string">""</span></span><span>) {
    </span><span><span class="hljs-variable">$count</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_substr_count</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-variable">$count</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>;
}
</span></span>

這樣可以減少不必要的函數調用，提高程序的性能。

5. 總結與註意事項

空字符串作為needle ：當子字符串為空時， mb_substr_count返回0。
空字符串作為haystack ：當目標字符串為空時， mb_substr_count也返回0。
性能優化：避免將空字符串作為needle傳入，檢查後再調用mb_substr_count可以提高效率。

了解這些細節，能幫助開發者在編寫PHP代碼時更好地使用mb_substr_count ，避免不必要的錯誤和性能問題。