preg_replace_callback_array
preg_replace_callback_array
(PHP 7)
preg_replace_callback_array — Perform a regular expression search and replace using callbacks
Description
mixed preg_replace_callback_array ( array $patterns_and_callbacks , mixed $subject [, int $limit = -1 [, int &$count ]] )
The behavior of this function is similar to preg_replace_callback(), except that callbacks are executed on a per-pattern basis.
Parameters
-
patterns_and_callbacks
-
An associative array mapping patterns (keys) to callbacks (values).
-
subject
-
The string or an array with strings to search and replace.
-
limit
-
The maximum possible replacements for each pattern in each
subject
string. Defaults to -1 (no limit). -
count
-
If specified, this variable will be filled with the number of replacements done.
Return Values
preg_replace_callback_array() returns an array if the subject
parameter is an array, or a string otherwise. On errors the return value is NULL
If matches are found, the new subject will be returned, otherwise subject
will be returned unchanged.
Examples
Example #1 preg_replace_callback_array() example
<?php $subject = 'Aaaaaa Bbb'; preg_replace_callback_array( [ '~[a]+~i' => function ($match) { echo strlen($match[0]), ' matches for "a" found', PHP_EOL; }, '~[b]+~i' => function ($match) { echo strlen($match[0]), ' matches for "b" found', PHP_EOL; } ], $subject ); ?>
The above example will output:
6 matches for "a" found 3 matches for "b" found
See Also
- PCRE Patterns
- preg_replace_callback() - Perform a regular expression search and replace using a callback
- preg_quote() - Quote regular expression characters
- preg_replace() - Perform a regular expression search and replace
- preg_last_error() - Returns the error code of the last PCRE regex execution
- Anonymous functions
- information about the callback type
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.preg-replace-callback-array.php