中文(繁體)
中文(繁體)
在PHP 中，字符串操作是非常常見且重要的任務。為了實現更加靈活的字符串處理，PHP 提供了許多有用的函數。 mb_stristr函數就是其中之一，它可以在多字節編碼字符串中查找某個子字符串，並且不區分大小寫。這個函數主要用於處理像UTF-8 或其他多字節字符集的字符串。
mb_stristr是PHP 中用於執行不區分大小寫的字符串查找的多字節版本函數。與普通的stristr函數類似， mb_stristr也會返回首次出現指定子字符串的部分，區別在於它可以正確地處理多字節字符集。
<span><span><span class="hljs-title function_ invoke__">mb_stristr</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">bool</span></span><span> </span><span><span class="hljs-variable">$before_needle</span></span><span> = </span><span><span class="hljs-literal">false</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><span class="hljs-keyword">string</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>$haystack ：這是要搜索的目標字符串。
$needle ：這是你要查找的子字符串。
$before_needle ：如果設置為true ，則返回的字符串將是從$haystack開始到$needle第一次出現的位置的部分。默認為false ，即返回$needle後面的部分。
$encoding ：指定字符編碼（如果未指定，默認使用內部字符編碼設置，通常是UTF-8）。
下面是一個簡單的示例，展示如何使用mb_stristr函數來查找不區分大小寫的子字符串。
<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 設置編碼為 UTF-8</span></span><span>
</span><span><span class="hljs-title function_ invoke__">mb_internal_encoding</span></span><span>(</span><span><span class="hljs-string">"UTF-8"</span></span><span>);
</span><span><span class="hljs-comment">// 目標字符串</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"Hello, 世界! Welcome to PHP."</span></span><span>;
</span><span><span class="hljs-comment">// 要查找的子字符串</span></span><span>
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"world"</span></span><span>;
</span><span><span class="hljs-comment">// 使用 mb_stristr 查找子字符串，不區分大小寫</span></span><span>
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_stristr</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">if</span></span><span> (</span><span><span class="hljs-variable">$result</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span>) {
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"找到了子字符串: "</span></span><span> . </span><span><span class="hljs-variable">$result</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"沒有找到子字符串。"</span></span><span>;
}
</span><span><span class="hljs-meta">?></span></span><span>
</span></span>mb_internal_encoding("UTF-8")設置了內部字符編碼為UTF-8，這樣可以確保多字節字符串正確處理。
我們使用mb_stristr($haystack, $needle)在$haystack中查找$needle 。由於mb_stristr是不區分大小寫的，所以"world" 和"World" 都會被認為是匹配的。
如果找到了匹配的子字符串，函數返回從匹配位置到字符串末尾的部分；如果沒有找到，則返回false 。
mb_stristr的一個重要特點是它能夠正確處理多字節字符集（如UTF-8、SJIS 等）。這使得它在處理非ASCII 字符串時，比stristr更加可靠。
例如，假設我們要查找中文字符：
<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 目標字符串包含中文字符</span></span><span>
</span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"我喜歡編程。"</span></span><span>;
</span><span><span class="hljs-comment">// 查找"喜歡"子字符串</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-comment">// 查找並返回匹配部分</span></span><span>
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_stristr</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">if</span></span><span> (</span><span><span class="hljs-variable">$result</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span>) {
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"找到了子字符串: "</span></span><span> . </span><span><span class="hljs-variable">$result</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"沒有找到子字符串。"</span></span><span>;
}
</span><span><span class="hljs-meta">?></span></span><span>
</span></span>在這個例子中， mb_stristr會正確識別"喜歡" 這個多字節字符，並返回從該子字符串開始的後續部分。
字符編碼：確保$haystack和$needle的字符編碼一致，特別是在處理多字節字符集時。如果編碼不匹配，可能會導致無法正確匹配或錯誤的結果。
性能考慮：與普通的stristr函數相比， mb_stristr的性能可能稍微遜色，特別是在大量文本中進行查找時。要根據實際情況考慮使用。
不返回原位置：與mb_strpos等函數不同， mb_stristr返回的是從匹配點開始的子字符串，而不是位置。如果你需要獲取位置，可以使用mb_strpos或mb_strrpos （反向查找）。
mb_stristr是PHP 中非常有用的函數，它允許我們在多字節字符集的字符串中進行不區分大小寫的查找操作。通過合理使用該函數，可以讓我們更輕鬆地處理UTF-8 或其他編碼的字符串，並進行靈活的字符串匹配。
