$pattern
, string $subject
[, array &$matches
[, int $flags
= 0 [, int$offset
= 0 ]]] )
搜索subject
与pattern
给定的正则表达式的一个匹配.
参数
-
要搜索的模式,字符串类型。
-
输入字符串。
-
如果提供了参数
matches
,它将被填充为搜索结果。 $matches[0]将包含完整模式匹配到的文本,$matches[1] 将包含第一个捕获子组匹配到的文本,以此类推。 -
flags
可以被设置为以下标记值:-
如果传递了这个标记,对于每一个出现的匹配返回时会附加字符串偏移量(相对于目标字符串的)。 注意:这会改变填充到
matches
参数的数组,使其每个元素成为一个由 第0个元素是匹配到的字符串,第1个元素是该匹配字符串 在目标字符串subject
中的偏移量。
PREG_OFFSET_CAPTURE
-
如果传递了这个标记,对于每一个出现的匹配返回时会附加字符串偏移量(相对于目标字符串的)。 注意:这会改变填充到
-
通常,搜索从目标字符串的开始位置开始。可选参数
offset
用于 指定从目标字符串的某个未知开始搜索(单位是字节)。
pattern
subject
matches
flags
offset
返回值
preg_match()返回 pattern
的匹配次数。 它的值将是0次(不匹配)或1次,因为preg_match()在第一次匹配后 将会停止搜索。preg_match_all()不同于此,它会一直搜索subject
直到到达结尾。 如果发生错误preg_match()返回FALSE
。
$pattern
, mixed $replacement
, mixed $subject
[, int $limit
= -1 [,int &$count
]] )
搜索subject
中匹配pattern
的部分, 以replacement
进行替换。
参数
-
要搜索的模式。可以使一个字符串或字符串数组。
可以使用一些PCRE修饰符, 包括被弃用的'e'(PREG_REPLACE_EVAL),可以为这个函数指定。
-
用于替换的字符串或字符串数组。如果这个参数是一个字符串,并且
pattern
是一个数组,那么所有的模式都使用这个字符串进行替换。如果pattern
和replacement
都是数组,每个pattern
使用replacement
中对应的 元素进行替换。如果replacement
中的元素比pattern
中的少, 多出来的pattern
使用空字符串进行替换。 -
要进行搜索和替换的字符串或字符串数组。
如果
subject
是一个数组,搜索和替换回在subject
的每一个元素上进行, 并且返回值也会是一个数组。 -
每个模式在每个
subject
上进行替换的最大次数。默认是 -1(无限)。 -
如果指定,将会被填充为完成的替换次数。
pattern
replacement
subject
limit
count
返回值
如果subject
是一个数组, preg_replace()返回一个数组, 其他情况下返回一个字符串。
如果匹配被查找到,替换后的subject
被返回,其他情况下 返回没有改变的 subject
。如果发生错误,返回 NULL
。
$pattern
, string $subject
[, int $limit
= -1 [, int $flags
= 0 ]] )
通过一个正则表达式分隔给定字符串.
参数
-
用于搜索的模式,字符串形式。
-
输入字符串
-
如果指定,将限制分隔得到的子串最多只有
limit
个,返回的最后一个 子串将包含所有剩余部分。limit
值为-1, 0或null时都代表"不限制", 作为php的标准,你可以使用null跳过对flags
的设置。 -
flags
可以是任何下面标记的组合(以位或运算 | 组合):- 如果这个标记被设置, preg_split() 将进返回分隔后的非空部分。
- 如果这个标记设置了,用于分隔的模式中的括号表达式将被捕获并返回。
-
如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量. 注意:这将会改变返回数组中的每一个元素, 使其每个元素成为一个由第0 个元素为分隔后的子串,第1个元素为该子串在
subject
中的偏移量组成的数组。
PREG_SPLIT_NO_EMPTY
PREG_SPLIT_DELIM_CAPTURE
PREG_SPLIT_OFFSET_CAPTURE
pattern
subject
limit
flags
$pattern
, array $input
[, int $flags
= 0 ] )
返回给定数组input
中与模式pattern
匹配的元素组成的数组.
参数
-
要搜索的模式, 字符串形式.
-
输入数组.
-
如果设置为
PREG_GREP_INVERT
, 这个函数返回输入数组中与 给定模式pattern
不匹配的元素组成的数组.
pattern
input
flags
返回值
返回使用input
中key做索引的数组.
返回自从 Unix 纪元(格林威治时间 1970 年 1 月 1 日 00:00:00)到当前时间的秒数。
$format
[, int $timestamp
] )
返回将整数 timestamp
按照给定的格式字串而产生的字符串。如果没有给出时间戳则使用本地当前时间。换句话说,timestamp
是可选的,默认值为 time()。