功能區塊 PREG_REPLACE

功能區塊 PREG_REPLACE 使用正則表達式進行搜尋和替換。

注意：此函數是二進位安全的。這意味着 UTF8 字元無法直接處理。

輸入 PATTERN

要搜尋的表達式字串。也有幾個 PCRE 修飾符可供使用。

輸入 REPLACEMENT

用於替換的字串。此字串可以包含形式為 \n 或 $n 的引用，後者更可取。這些引用中的每一個都會被第 n 個括號內的搜尋模式捕獲的文字替換。n 可以是 0 到 99 之間的值。\0 或 $0 指的是與完整搜尋模式匹配的文字。要獲取捕獲子搜尋模式的編號，從左到右開始計算開放括號，起始值為 1。若要在替換中使用反斜線，必須將其加倍 "\\"。

如果您想要處理一個替換，其中後向引用直接跟隨另一個數字（即，在與搜尋模式匹配之後，應該有一個數字），則不能使用 \1 形式的寫法來進行後向引用。例如，\11 會使函數感到困惑，因為它不知道您是想要後向引用 \1 後跟隨數字 1，還是僅僅後向引用 \11。此時的解決方案是使用 ${1}1。這樣會產生一個孤立的後向引用 $1，而 1 則保持為字母符號。

如果您使用過時的修飾符 e，此函數會對用於替換後向引用的字串中的幾個字元進行遮罩（即 '、"、\ 和 NULL）。這是為了確保在使用包含單引號或雙引號的後向引用時不會發生語法錯誤。請務必了解字串語法，以便準確知道評估後的字串看起來如何。

輸入 SUBJECT

此輸入定義要搜尋的字串。

輸入 LIMIT

每個 subject 中每個搜尋模式的最大可能替換次數。預設值：-1 或 NULL（無限制）。

輸出 Q

如果找到匹配項，則返回新字串 Q；否則，返回未修改的 SUBJECT 或 NULL，如果發生錯誤。

輸出 COUNT

此輸出返回所執行替換的次數。