如何解決PHP 中strcspn 和strstr 函數一起使用時遇到的常見問題？

gitbox 2025-06-18

在PHP 中， strcspn()和strstr()是兩個非常實用的字符串處理函數。 strcspn()用於計算字符串中從開頭開始遇到的第一個與指定字符集不匹配的字符的位置，而strstr()則用於查找一個字符串在另一個字符串中的首次出現。這兩個函數在某些情況下需要一起使用，但在結合使用時可能會遇到一些常見問題。本文將分析這些問題，並提供解決方法。

1. 函數簡介

strcspn() ：
strcspn(string $haystack, string $charlist): int
該函數計算並返回$haystack中從開頭開始遇到的第一個與$charlist中任何字符不匹配的字符位置。如果沒有找到匹配的字符，則返回整個字符串的長度。
strstr() ：
strstr(string $haystack, string $needle, bool $before_needle = false): string|false
該函數返回$haystack字符串中首次出現$needle子字符串的位置。參數$before_needle如果設置為true ，則會返回$needle出現之前的部分。

2. 常見問題

2.1 問題一：strcspn 與strstr 順序問題

許多開發者可能會在一起使用這兩個函數時遇到順序混亂的問題。因為strcspn()返回的是一個位置，而strstr()通常用於從字符串的某個位置開始查找子字符串。如果不小心反向調用，可能會導致無法正確定位所需的字符串位置。

示例：

 <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">"World"</span></span><span>;
</span><span><span class="hljs-variable">$charlist</span></span><span> = </span><span><span class="hljs-string">",!"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strcspn</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$charlist</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__">strstr</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-comment">// 查找 "World" 是否在 $haystack 中</span></span><span>
</span></span>

這種方式並不會根據strcspn()得到的位置來查找子字符串。 strstr()將始終從字符串的開頭查找。

解決方案：

使用strstr()前，可以通過strcspn()計算得到正確的起始位置，然後用substr()截取$haystack的子字符串，從而確保正確的查找範圍。

 <span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strcspn</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$charlist</span></span><span>);
</span><span><span class="hljs-variable">$substring</span></span><span> = </span><span><span class="hljs-title function_ invoke__">substr</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$position</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__">strstr</span></span><span>(</span><span><span class="hljs-variable">$substring</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);     </span><span><span class="hljs-comment">// 在子字符串中查找 "World"</span></span><span>
</span></span>

2.2 問題二：strcspn 和strstr 返回false

strcspn()在沒有找到指定字符集時，返回字符串的長度，而strstr()如果沒有找到目標子字符串，則返回false 。在一起使用時，如果沒有考慮到返回值的異常情況，可能會導致程序出錯或邏輯不清晰。

示例：

 <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">"PHP"</span></span><span>;
</span><span><span class="hljs-variable">$charlist</span></span><span> = </span><span><span class="hljs-string">",!"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strcspn</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$charlist</span></span><span>);
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strstr</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-comment">// 找不到 "PHP"，返回 false</span></span><span>
</span></span>

在上述代碼中， strstr()返回了false ，因為"PHP"並不在$haystack中。然而，開發者可能會沒有處理false的情況，導致後續操作失敗。

解決方案：

在使用strstr()之前，檢查是否能成功找到子字符串。

 <span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strcspn</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$charlist</span></span><span>);
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strstr</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-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-variable">$result</span></span><span>;
}
</span></span>

2.3 問題三：多次調用導致性能問題

strcspn()和strstr()都是字符串操作函數，當在大量數據上頻繁調用時，可能會影響性能。尤其是在循環中，重複計算strcspn()和strstr()可能導致不必要的重複操作，特別是在需要多次查找多個子字符串或字符集時。

解決方案：
在循環之前對目標字符串進行預處理，避免在每次迭代中重複調用。

 <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">"World"</span></span><span>;
</span><span><span class="hljs-variable">$charlist</span></span><span> = </span><span><span class="hljs-string">",!"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strcspn</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$charlist</span></span><span>);
</span><span><span class="hljs-variable">$substring</span></span><span> = </span><span><span class="hljs-title function_ invoke__">substr</span></span><span>(</span><span><span class="hljs-variable">$haystack</span></span><span>, </span><span><span class="hljs-variable">$position</span></span><span>);
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strstr</span></span><span>(</span><span><span class="hljs-variable">$substring</span></span><span>, </span><span><span class="hljs-variable">$needle</span></span><span>);

</span><span><span class="hljs-comment">// 進一步的操作</span></span><span>
</span></span>

通過在最初就計算好位置，並提取需要處理的子字符串，可以避免不必要的重複查找。

3. 結論

在PHP 中結合使用strcspn()和strstr()時，遇到的常見問題主要集中在函數調用的順序、返回值的處理以及性能優化上。理解這兩個函數的返回值以及合理地進行錯誤檢查，可以有效避免常見的陷阱。此外，對於高效處理大量數據，合理的預處理和避免重複計算也是至關重要的。

通過本篇文章的介紹，希望大家在實際開發中能夠更好地利用這兩個函數，提高代碼的穩定性和效率。