PREG_QUOTE(3) 1 PREG_QUOTE(3)preg_quote - Quote regular expression charactersSYNOPSIS
string preg_quote NULL (string $str, [string $delimiter])
DESCRIPTION preg_quote(3) takes $str and puts a backslash in front of every character that is part of the regular expression syntax. This is useful if
you have a run-time string that you need to match in some text and the string may contain special regex characters.
The special regular expression characters are: . + * ? [ ^ ] $ ( ) { } = ! < > | : -
PARAMETERS
o $str
- The input string.
o $delimiter
- If the optional $delimiter is specified, it will also be escaped. This is useful for escaping the delimiter that is required by
the PCRE functions. The / is the most commonly used delimiter.
RETURN VALUES
Returns the quoted (escaped) string.
CHANGELOG
+--------+--------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+--------------------------------+
| 5.3.0 | |
| | |
| | The - character is now quoted |
| | |
+--------+--------------------------------+
EXAMPLES
Example #1
preg_quote(3) example
<?php
$keywords = '$40 for a g3/400';
$keywords = preg_quote($keywords, '/');
echo $keywords; // returns $40 for a g3/400
?>
Example #2
Italicizing a word within some text
<?php
// In this example, preg_quote($word) is used to keep the
// asterisks from having special meaning to the regular
// expression.
$textbody = "This book is *very* difficult to find.";
$word = "*very*";
$textbody = preg_replace ("/" . preg_quote($word, '/') . "/",
"<i>" . $word . "</i>",
$textbody);
?>
NOTES
Note
This function is binary-safe.
SEE ALSO
PCRE Patterns, escapeshellcmd(3).
PHP Documentation Group PREG_QUOTE(3)
Check Out this Related Man Page
PREG_FILTER(3) 1 PREG_FILTER(3)preg_filter - Perform a regular expression search and replaceSYNOPSIS
mixed preg_filter (mixed $pattern, mixed $replacement, mixed $subject, [int $limit = -1], [int &$count])
DESCRIPTION preg_filter(3) is identical to preg_replace(3) except it only returns the (possibly transformed) subjects where there was a match. For
details about how this function works, read the preg_replace(3) documentation.
RETURN VALUES
Returns an array if the $subject parameter is an array, or a string otherwise.
If no matches are found or an error occurred, an empty array is returned when $subject is an array or NULL otherwise.
EXAMPLES
Example #1
Example comparing preg_filter(3) with preg_replace(3)
<?php
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4');
$pattern = array('/d/', '/[a-z]/', '/[1a]/');
$replace = array('A:$0', 'B:$0', 'C:$0');
echo "preg_filter returns
";
print_r(preg_filter($pattern, $replace, $subject));
echo "preg_replace returns
";
print_r(preg_replace($pattern, $replace, $subject));
?>
The above example will output:
preg_filter returns
Array
(
[0] => A:C:1
[1] => B:C:a
[2] => A:2
[3] => B:b
[4] => A:3
[7] => A:4
)
preg_replace returns
Array
(
[0] => A:C:1
[1] => B:C:a
[2] => A:2
[3] => B:b
[4] => A:3
[5] => A
[6] => B
[7] => A:4
)
SEE ALSO
PCRE Patterns, preg_quote(3), preg_replace(3), preg_replace_callback(3), preg_grep(3), preg_last_error(3).
PHP Documentation Group PREG_FILTER(3)