1. preg_match — 执行一个正则表达式匹配
int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )
搜索subject与pattern给定的正则表达式的一个匹配.
pattern:
要搜索的模式,字符串类型。
subject :
输入字符串。
matches:
如果提供了参数matches,它将被填充为搜索结果。 $matches[0]将包含完整模式匹配到的文本, $matches[1]将包含第一个捕获子组匹配到的文本,以此类推。
flags:
flags可以被设置为以下标记值:PREG_OFFSET_CAPTURE 如果传递了这个标记,对于每一个出现的匹配返回时会附加字符串偏移量(相对于目标字符串的)。 注意:这会改变填充到matches参数的数组,使其每个元素成为一个由 第0个元素是匹配到的字符串,第1个元素是该匹配字符串 在目标字符串subject中的偏移量。
offset:
通常,搜索从目标字符串的开始位置开始。可选参数 offset 用于 指定从目标字符串的某个未知开始搜索(单位是字节)。
返回值:
preg_match()返回 pattern 的匹配次数。 它的值将是0次(不匹配)或1次,因为 preg_match()在第一次匹配后 将会停止搜索。 preg_match_all()不同于此,它会一直搜索subject直到到达结尾。 如果发生错误 preg_match()返回 FALSE。
示例:
- echo"/,\s*(php)/i""In my point, PHP is the web scripting language of choice." echo"
""\n" $matchesarray "/,\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" "/,\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" - "/[,a-z]?\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" ?>
2.preg_match_all — 执行一个全局正则表达式匹配
int preg_match_all ( string $pattern , string $subject [, array &$matches [, int $flags = PREG_PATTERN_ORDER [, int $offset = 0 ]]] )
搜索subject中所有匹配pattern给定正则表达式 的匹配结果并且将它们以flag指定顺序输出到matches中. 在第一个匹配找到后, 子序列继续从最后一次匹配位置搜索.
pattern:
要搜索的模式,字符串形式。
subject :
输入字符串。
matches:
多维数组,作为输出参数输出所有匹配结果, 数组排序通过flags指定。
flags:
可以结合下面标记使用(注意不能同时使用PREG_PATTERN_ORDER和PREG_SET_ORDER),如果没有给定排序标记,假定设置为PREG_PATTERN_ORDER:
PREG_PATTERN_ORDER:
结果排序为$matches[0]保存完整模式的所有匹配,$matches[1]保存第一个子组的所有匹配,以此类推。
PREG_SET_ORDER:
结果排序为$matches[0]包含第一次匹配得到的所有匹配(包含子组),$matches[1]是包含第二次匹配到的所有匹配(包含子组)的数组,以此类推。
PREG_OFFSET_CAPTURE:
如果这个标记被传递,每个发现的匹配返回时会增加它相对目标字符串的偏移量。注意这会改变matches中的每一个匹配结果字符串元素,使其 成为一个第0个元素为 匹配结果字符串,第1个元素为匹配结果字符串在subject中的偏移量。
返回值:
返回完整匹配次数(可能是0),或者如果发生错误返回FALSE。所以可以用preg_match_all()函数来获取字符串出现的次数.
推荐用substr_count() 函数计算子串在字符串中出现的次数.
示例:
- echo"/php/i""In my point, PHP is the web scripting language of choice. I love php"$matches echo"
""\n" - $matchesarray "/[,a-z]?\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" - $matchesarray "/[,a-z]?\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" - $matchesarray "/[,a-z]?\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" - $matchesarray "/[,a-z]?\s*(php)/i""In my point, PHP is the web scripting language of choice. I love php"$matches $matches echo"
""\n" ?>
3.preg_split — 通过一个正则表达式分隔字符串
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )
通过一个正则表达式分隔给定字符串.
pattern:
用于搜索的模式,字符串形式。
subject:
输入字符串
limit:
如果指定,将限制分隔得到的子串最多只有limit个,返回的最后一个 子串将包含所有剩余部分。limit值为-1, 0或null时都代表"不限制", 作为php的标准,你可以使用null跳过对flags的设置。
flags:
flags 可以是任何下面标记的组合(以位或运算 | 组合):
PREG_SPLIT_NO_EMPTY:
如果这个标记被设置, preg_split()将进返回分隔后的非空部分。
PREG_SPLIT_DELIM_CAPTURE:
如果这个标记设置了,用于分隔的模式中的括号表达式将被捕获并返回。
PREG_SPLIT_OFFSET_CAPTURE:
如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量.注意:这将会改变返回数组中的每一个元素,使其每个元素成为一个由第0个元素为分隔后的子串,第1个元素为该子串在subject中的偏移量组成的数组。
返回值:
返回一个使用 pattern 边界分隔 subject 后得到 的子串组成的数组。
示例:
- $matchesarray "/php/i""In my point, PHP is the web scripting language of choice. I love php" echo"
""\n" - $matchesarray "/php/i""In my point, PHP is the web scripting language of choice. I love php" echo"
""\n" - $matchesarray "/php/i""In my point, PHP is the web scripting language of choice. I love php" echo"
""\n" ?>
4.preg_quote — 转义正则表达式字符
string preg_quote ( string $str [, string $delimiter = NULL ] )
preg_quote()需要参数 str 并向其中 每个正则表达式语法中的字符前增加一个反斜线。 这通常用于你有一些运行时字符串 需要作为正则表达式进行匹配的时候。
正则表达式特殊字符有: . \ + * ? [ ^ ] $ ( ) { } = ! < > | : -
str:
输入字符串
delimiter:
如果指定了可选参数delimiter,它也会被转义。这通常用于 转义PCRE函数使用的分隔符。/是最通用的分隔符。
返回值:
返回转义后的字符串。
示例:
- //在这个例子中,preg_quote($word) 用于保持星号原文涵义,使其不使用正则表达式中的特殊语义。 $textbody"This book is *very* difficult to find." $word"*very*" $textbody"/"$word"/"""$word""$textbody //将会输出This book is *very* difficult to find. echo$textbody ?>
5.preg_grep — 返回匹配模式的数组条目
array preg_grep ( string $pattern , array $input [, int $flags = 0 ] )
返回给定数组input中与模式pattern匹配的元素组成的数组.
pattern:
要搜索的模式, 字符串形式.
input:
输入数组.
flags:
如果设置为PREG_GREP_INVERT, 这个函数返回输入数组中与 给定模式pattern不匹配的元素组成的数组.
返回值:
返回使用input中key做索引的数组.
示例:
- $arrayarray"abc""dd""123""123.22""word123""33.2""0.22" //返回所有包含浮点数的元素 //输出:Array ( [3] => 123.22 [5] => 33.2 [6] => 0.22 ) $fl_array"/^(\d+)?\.\d+$/"$array $fl_array //返回所有包含浮点数的元素 //输出:Array ( [0] => abc [1] => dd [2] => 123 [4] => word123 ) $fl_array"/^(\d+)?\.\d+$/"$array $fl_array ?>
6.preg_replace — 执行一个正则表达式的搜索和替换
mixed preg_replace ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] )
搜索subject中匹配pattern的部分, 以replacement进行替换。
pattern:
要搜索的模式。可以是一个字符串或字符串数组。 可以使用一些PCRE修饰符, 包括'e'(PREG_REPLACE_EVAL),可以为这个函数指定。
replacement:
用于替换的字符串或字符串数组。如果这个参数是一个字符串,并且pattern是一个数组,那么所有的模式都使用这个字符串进行替换。如果pattern和replacement都是数组,每个pattern使用replacement中对应的元素进行替换。如果replacement中的元素比pattern中的少,多出来的pattern使用空字符串进行替换。replacement中可以包含后向引用\\n或(php4.0.4以上可用)$n,语法上首选后者。 每个 这样的引用将被匹配到的第n个捕获子组捕获到的文本替换。n可以是0-99,\\0和$0代表完整的模式匹配文本。 捕获子组的序号计数方式为:代表捕获子组的左括号从左到右,从1开始数。如果要在replacement中使用反斜线,必须使用4个("\\\\",译注:因为这首先是php的字符串,经过转义后,是两个,再经过正则表达式引擎后才被认为是一个原文反斜线)。 当在替换模式下工作并且后向引用后面紧跟着需要是另外一个数字(比如:在一个匹配模式后紧接着增加一个原文数字),不能使用\\1这样的语法来描述后向引用。比如, \\11将会使preg_replace()不能理解你希望的是一个\\1后向引用紧跟一个原文1,还是 一个\\11后向引用后面不跟任何东西。这种情况下解决方案是使用${1}1。 这创建了一个独立的$1后向引用, 一个独立的原文1。 当使用e修饰符时,这个函数会转义一些字符(即:'、"、 \ 和 NULL) 然后进行后向引用替换。当这些完成后请确保后向引用解析完后没有单引号或双引号引起的语法错误(比如: 'strlen(\'$1\')+strlen("$2")')。确保符合PHP的字符串语法,并且符合eval语法。因为在完成替换后,引擎会将结果字符串作为php代码使用eval方式进行评估并将返回值作为最终参与替换的字符串。
subject:
要进行搜索和替换的字符串或字符串数组。如果subject是一个数组,搜索和替换回在subject的每一个元素上进行,并且返回值也会是一个数组。
limit:
每个模式在每个subject上进行替换的最大次数。默认是 -1(无限)。
count:
如果指定,将会被填充为完成的替换次数。
返回值:
如果subject是一个数组, preg_replace()返回一个数组, 其他情况下返回一个字符串。 如果匹配被查找到,替换后的subject被返回,其他情况下 返回没有改变的 subject。如果发生错误,返回 NULL 。
示例:
使用后向引用紧跟数值原文:
- $string'April 15, 2003' $pattern'/(\w+) (\d+), (\d+)/i'
- $replacement'$0:
${1}1,\\3' echo$pattern$replacement$string ?>
preg_replace()中使用基于索引的数组:
- $string'The quick brown fox jumped over the lazy dog.' $patternsarray $patterns'/quick/' $patterns'/brown/' $patterns'/fox/' $replacementsarray $replacements'bear' $replacements'black' $replacements'slow' //会输出:The bear black slow jumped over the lazy dog. echo$patterns$replacements$string //对模式和替换内容按key进行排序我们可以得到期望的结果. $patterns $replacements //会输出:The slow black bear jumped over the lazy dog. echo$patterns$replacements$string);
替换一些值:
- $patternsarray'/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/' '/^\s*{(\w+)}\s*=/' $replacearray'\3/\4/\1\2''$\1 =' echo$patterns$replace'{startDate} = 1999-5-27' ?>
使用修饰符'e':
- $html_body"
;
- //会输出:
- echo"/(<\/?)(\w+)([^>]*>)/e" "'\\1'.strtoupper('\\2').'\\3'" $html_body ?>
剥离空白字符:
- $str'foo o' $str'/\s\s+/'' '$str // 将会改变为'foo o' echo$str ?>
使用参数count:
- $count echoarray'/\d/''/\s/''*''xp 4 to'$count //等价于echo preg_replace('/\d|\s/', '', 'xp 4 to', -1 , $count); echo$count//3 ?>
7.preg_replace_callback — 执行一个正则表达式搜索并且使用一个回调进行替换
mixed preg_replace_callback ( mixed $pattern , callable $callback , mixed $subject [, int $limit = -1 [, int &$count ]] )
这个函数的行为除了 可以指定一个 callback 替代 replacement 进行替换 字符串的计算,其他方面等同于 preg_replace()。
pattern:
要搜索的模式,可以使字符串或一个字符串数组。
callback:
一个回调函数,在每次需要替换时调用,调用时函数得到的参数是从subject中匹配到的结果。回调函数返回真正参与替换的字符串。
你可能经常会需要callback函数而 仅用于 preg_replace_callback()一个地方的调用。在这种情况下,你可以使用匿名函数来定义一个匿名函数作为preg_replace_callback()调用时的回调。 这样做你可以保留所有 调用信息在同一个位置并且不会因为一个不在任何其他地方使用的回调函数名称而污染函数名称空间。
subject:
要搜索替换的目标字符串或字符串数组。
limit:
对于每个模式用于每个 subject 字符串的最大可替换次数。 默认是-1(无限制)。
count:
如果指定,这个变量将被填充为替换执行的次数。
示例:
preg_replace_callback() 和 create_function():
- // 将文本中的年份增加一年.
- $text"April fools day is 04/01/2002\n"
- $text"Last christmas was 12/24/2001\n"
- // 回调函数 function$matches
- // 通常: $matches[0]是完成的匹配
- // $matches[1]是第一个捕获子组的匹配
- // 以此类推
- return$matches$matches
- echo "|(\d{2}/\d{2}/)(\d{4})|" "next_year" $text //使用create_function echo "|(\d{2}/\d{2}/)(\d{4})|" '$matches' 'return $matches[1].($matches[2]+1);' $text ?>