PHP preg_replace() 函式
示例
使用不區分大小寫的正則表示式將字串中的 Microsoft 替換為 W3Schools
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo preg_replace($pattern, 'W3Schools', $str);
?>
自己動手試一試 »
定義和用法
preg_replace()
函式返回一個字串或一組字串,其中輸入字串中找到的所有匹配的模式或模式列表都被替換為子字串。
該函式有三種不同的用法:
1. 一個模式和一個替換字串。匹配的模式將被替換為替換字串。
2. 一個模式陣列和一個替換字串。匹配的任何模式都將被替換為替換字串。
3. 一個模式陣列和一個替換字串陣列。每個模式的匹配都將被替換為替換陣列中相同位置的替換字串。如果該位置沒有找到專案,則匹配將被替換為空字串。
替換字串可能包含反向引用,形式為 \n 或 $n,其中 n 是模式中某個組的索引。在返回的字串中,\n 和 $n 的例項將被匹配的組的子字串替換,或者,如果使用 \0 或 $0,則會被整個表示式替換。
注意:對於每個輸入字串,函式按給定順序評估模式。第二個模式將使用第一個模式字串的評估結果作為輸入字串,以此類推。這可能會導致意外行為。
語法
preg_replace(patterns, replacements, input, limit, count)
引數值
引數 | 描述 |
---|---|
patterns | 必需。包含正則表示式或正則表示式陣列 |
replacements | 必需。替換字串或替換字串陣列 |
input | 必需。執行替換的字串或字串陣列 |
limit | 可選。預設為 -1,表示不限制。設定在每個字串中可以執行的替換次數 |
count | 可選。函式執行後,此變數將包含一個數字,指示執行了多少次替換 |
技術詳情
返回值 | 返回透過將替換應用於輸入字串或字串而生成的字串或字串陣列 |
---|---|
PHP 版本 | 4.0.5+ |
更新日誌 | PHP 5.1.0 - 添加了 count 引數 |
❮ PHP 正則表示式參考