在使用PHP strpos 函數時傳遞負數參數會發生什麼？深入解析其行為

gitbox 2025-07-17

在PHP 中， strpos函數用於查找字符串中首次出現子字符串的位置。該函數的基本語法如下：

 <span><span><span class="hljs-title function_ invoke__">strpos</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">mixed</span></span><span> </span><span><span class="hljs-variable">$needle</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$offset</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>): </span><span><span class="hljs-keyword">int</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

其中， $haystack是目標字符串， $needle是要查找的子字符串， $offset是可選的偏移量參數，表示從哪個位置開始查找。

通常情況下， strpos會返回子字符串首次出現的位置的索引（從0 開始計數）。如果找不到子字符串，則返回false 。

PHP strpos的正常行為

首先，了解strpos函數的正常行為是很重要的。在沒有傳遞偏移量（ $offset ）時，函數會從字符串的開頭開始查找。考慮以下示例：

 <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">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</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">$position</span></span><span>; </span><span><span class="hljs-comment">// 輸出 7</span></span><span>
</span></span>

在這個例子中， strpos返回7 ，這是"world" 在"Hello, world!" 中首次出現的位置。

$offset參數的作用

strpos函數的第三個參數$offset是可選的。它允許我們指定從目標字符串的哪個位置開始查找。例如：

 <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">"o"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</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-number">5</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$position</span></span><span>; </span><span><span class="hljs-comment">// 輸出 8</span></span><span>
</span></span>

在這個例子中， strpos從索引5 開始查找，因此它返回"world" 中第二個"o" 的位置，即8。

傳遞負數給$offset參數時的行為

當我們傳遞一個負數作為$offset參數時， strpos函數會從目標字符串的末尾向前查找。具體來說，負數偏移量表示從字符串的末尾開始偏移，負數的絕對值就是從末尾開始計數的字符數。

舉個例子：

 <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">"o"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</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-number">6</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$position</span></span><span>; </span><span><span class="hljs-comment">// 輸出 8</span></span><span>
</span></span>

在這個例子中， -6表示從字符串的末尾（"!"字符之後）向前數6 個字符，即從"world!" 的位置開始查找。 strpos找到"o" 的位置，並返回了8。

負數$offset的解析過程

讓我們再看一個例子來深入理解負數偏移量的工作原理：

 <span><span><span class="hljs-variable">$haystack</span></span><span> = </span><span><span class="hljs-string">"abcdef"</span></span><span>;
</span><span><span class="hljs-variable">$needle</span></span><span> = </span><span><span class="hljs-string">"c"</span></span><span>;

</span><span><span class="hljs-variable">$position</span></span><span> = </span><span><span class="hljs-title function_ invoke__">strpos</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-number">2</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$position</span></span><span>; </span><span><span class="hljs-comment">// 輸出 2</span></span><span>
</span></span>

在這個例子中，偏移量-2表示從字符串"abcdef" 的倒數第二個字符"e" 向前查找。 strpos函數會從"e" 開始，查找子字符串"c"。由於"c" 在從倒數第二個字符向前數時的第2 個位置上，它返回2 作為結果。

注意事項

雖然使用負數偏移量非常靈活，但我們仍然需要注意幾個關鍵點：

偏移量不能過度負數：如果負數的絕對值大於目標字符串的長度， strpos將從字符串的開始位置查找。例如，如果你傳遞-20作為偏移量，而目標字符串只有10 個字符， strpos將等效於從開始位置查找。
結果可能不如預期：負數偏移量使得查找變得相對複雜。在實際開發中，如果不確定字符串的長度或者查找的起點，可能會導致錯誤的結果。因此，開發者應該確保理解偏移量與目標字符串長度之間的關係。

總結

PHP 的strpos函數在傳遞負數偏移量時會從字符串的末尾向前查找，這提供了更多靈活性。但同時，使用負數偏移量時需要謹慎，確保偏移量的絕對值不超過字符串的長度。理解這一點，可以幫助開發者更準確地控制查找操作，避免不必要的錯誤。

strpos