preg_replace

名稱:preg_replace

分類:正則處理PCRE

所屬語言:php

一句話介紹:返回字符串，其中模式的匹配項被替換為給定字符串中的子字符串。

定義和用法

preg_replace()函數返回一個字符串或字符串數組，其中輸入中找到的模式或模式列表的所有匹配項都被替換為子字符串。

這個函數有三種不同的使用方式：

一個模式和一個替換字符串。模式的匹配項將被替換字符串替換。
一個模式數組和一個替換字符串。匹配數組中的任何一個模式都將被替換字符串替換。
一個模式數組和一個替換字符串數組。每個模式的匹配項都將被替換字符串數組中相同位置的字符串替換。如果在替換數組中的那個位置沒有找到項，則匹配項將被替換為空字符串。

替換字符串可以包含以\n 或n 形式出現的後向引用，其中n是模式中的組的索引。在返回的字符串中，\n 和n 的實例將被該組匹配的子字符串替換，或者，如果使用了\0 或$0，則將被整個表達式替換。

注意：對於每個輸入字符串，函數按照給定的順序評估模式。在字符串上評估第一個模式的結果將用作第二個模式的輸入字符串，依此類推。這可能會導致意外的行為。

使用不區分大小寫的正則表達式，在字符串中將"Microsoft" 替換為"W3School"：

 <?php
$str = 'Visit Microsoft!' ;
$pattern = '/microsoft/i' ;
echo preg_replace ( $pattern , 'W3School' , $str ) ;
?>

親自試一試

preg_replace ( patterns , replacements , input , limit , count )

參數	描述
patterns	必需。包含正則表達式或正則表達式數組。
replacements	必需。替換字符串或替換字符串數組。
input	必需。在其上進行替換的字符串或字符串數組。
limit	可選。默認為-1，表示無限制。設置在每個字符串中可以進行的替換次數的限制。
count	可選。函數執行後，該變量將包含一個數字，指示執行了多少次替換。