空の文字列に遭遇したときにMB_Substr_Countは何を返しますか？結果分析と予防策

gitbox 2025-09-02

PHPでは、 MB_Substr_Count関数を使用して、別のサブストリングが文字列に表示される回数を計算します。この関数は、UTF-8エンコーディングなどのマルチバイト文字を含む文字列を処理するために特別に使用されるマルチバイトストリング拡張（MBSTring）の一部です。 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 ：検索されたターゲット文字列。
$針：ターゲット文字列で探すサブストリング。
$エンコード：オプションのパラメーター、文字エンコードを指定します。内部文字エンコードはデフォルトで使用されます。

この関数は、$ haystack **に表示される回数** $ heedleを返します。

1。動作MB_SUBSTR_COUNTが空の文字列をサブストリングとして遭遇するとき

空の文字列をサブストリング（すなわち$針）としてmb_substr_count関数に渡すとします。PHPドキュメントによると、ターゲット文字列に含まれるサブストリングの発生数は返されます。

例1：針として空のサブストリング

<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>

上記のコードでは、 $針は空の文字列です。ターゲット文字列$ haystackは空ではありませんが、PHPは空の文字列を「表示されていないサブストリング」として扱います。したがって、関数は0を返します。

2。動作空のターゲット文字列が干し草スタックとして使用される場合

ターゲット文字列$ haystackがmb_substr_countに渡された場合、空の文字列（つまり、 $ haystack = "" ）である場合、返品値は$針に関係なく0になります。空の文字列には、サブストリングに関係なく、サブストリングを含めることができないためです。

例2：ヘイスタックとしての空のターゲット文字列

<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>

ここでは、 $針は「こんにちは」ですが、空の文字列$ haystackには何も含まれていないため、0が返されます。

3。空の文字列の特別な状況の要約

上記の2つの例から、 MB_Substr_Countは空の文字列で直感的に動作することがわかります。

サブストリングが空の場合は、サブストリングが一致できないため0を返します。
ターゲット文字列が空の場合、空の文字列にはサブストリングが含まれないために0が返されます。

これらの2つの状況は、 MB_Substr_Count関数で比較的一般的な「境界の状況」であり、それを使用する際には注意を払う必要があります。

4。パフォーマンスに関する考慮事項

ほとんどの場合、空の文字列の動作は問題ではありませんが、コードの読みやすさと効率を改善するために、空の文字列をMB_SUBSTR_COUNTにパラメーターとして渡すことを避けることをお勧めします。 $針が空の文字列である場合は、 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。概要と予防策

針としての空の文字列： MB_SUBSTR_COUNTサブストリングが空のときに0を返します。
Haystackとしての空の文字列： MB_Substr_Countは、ターゲット文字列が空の場合に0を返します。
パフォーマンスの最適化：空の文字列を針として渡すことを避け、チェック後にmb_substr_countを呼び出すことで効率を向上させることができます。

これらの詳細を理解することで、PHPコードを書くときに開発者がMB_Substr_Countをよりよく使用するのに役立ち、不必要なエラーやパフォーマンスの問題を回避できます。