PHP Conference Japan 2024

iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strpos尋找字串在另一字串中第一次出現的位置

說明

iconv_strpos(
    字串 $haystack,
    字串 $needle,
    整數 $offset = 0,
    ?字串 $encoding = null
): 整數 (int)|false

尋找 needlehaystack 中第一次出現的位置。

strpos() 不同的是,iconv_strpos() 的返回值是 needle 之前出現的字元數量,而不是 needle 被找到的位置的位元組偏移量。字元計算是基於指定的字元集 encoding

參數

haystack

整個字串。

needle

要搜尋的子字串。

offset

可選的 offset 參數指定開始搜尋的位置。如果 offset 為負數,則從字串的結尾開始計算。

encoding

如果省略 encoding 參數或設定為 null,則假設 string 使用 iconv.internal_encoding 編碼。

如果 haystackneedle 不是字串,它會被轉換為字串,並套用為字元的序數值。

返回值

返回 needlehaystack 中第一次出現的數字位置。

如果找不到 needleiconv_strpos() 將返回 false

警告

此函式可能會返回布林值 false,但也可能返回評估為 false 的非布林值。請閱讀 布林值 章節以了解更多資訊。使用 === 運算子 來測試此函式的返回值。

更新日誌

版本 說明
8.0.0 encoding 現在可以為 null。
7.1.0 已新增對負 offset 的支援。

另請參閱

  • strpos() - 尋找子字串在字串中第一次出現的位置
  • iconv_strrpos() - 尋找 needle 在 haystack 中最後一次出現的位置
  • mb_strpos() - 尋找字串在另一個字串中第一次出現的位置

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top