Function __global->cms_preg_match_all_safe
Definitions
sources/global3.php
- Perform a global regular expression match.Automatically applies utf-8 if possible and appropriate. \s is not actually Unicode-safe, for example (as it matches non-breaking-spaces).Also automatically applies the 'D' modifier so that trailing blank lines don't mess with '$'.
- Visibility: public
- Is abstract?: No
- Is static?: No
- Is final?: No
Parameters
| Name | Type | Passed by reference? | Variadic? | Default | Set | Range | Description |
|---|---|---|---|---|---|---|---|
| $pattern | string | No | No | required parameter | N/A | N/A | The pattern |
| $subject | string | No | No | required parameter | N/A | N/A | The subject string |
| &$matches | ?array | Yes | No | required parameter | N/A | N/A | Where matches will be put (note that it is a list of maps, except the arrays are turned inside out). Note that this is actually passed by reference, but is also optional. (null: don't gather) |
| $flags | integer | No | No | 0 | N/A | N/A | Either 0, or PREG_OFFSET_CAPTURE |
Returns
- The number of matches (false: error)
- Type: ~integer
- Set: N/A
- Range: N/A
Preview
Code (PHP)
/**
* Perform a global regular expression match.Automatically applies utf-8 if possible and appropriate. \s is not actually Unicode-safe, for example (as it matches non-breaking-spaces).Also automatically applies the 'D' modifier so that trailing blank lines don't mess with '$'.
*
* @param string $pattern The pattern
* @param string $subject The subject string
* @param ?array $matches Where matches will be put (note that it is a list of maps, except the arrays are turned inside out). Note that this is actually passed by reference, but is also optional. (null: don't gather)
* @param integer $flags Either 0, or PREG_OFFSET_CAPTURE
* @return ~integer The number of matches (false: error)
*/
function cms_preg_match_all_safe(string $pattern, string $subject, ?array &$matches, int $flags = 0)
* Perform a global regular expression match.Automatically applies utf-8 if possible and appropriate. \s is not actually Unicode-safe, for example (as it matches non-breaking-spaces).Also automatically applies the 'D' modifier so that trailing blank lines don't mess with '$'.
*
* @param string $pattern The pattern
* @param string $subject The subject string
* @param ?array $matches Where matches will be put (note that it is a list of maps, except the arrays are turned inside out). Note that this is actually passed by reference, but is also optional. (null: don't gather)
* @param integer $flags Either 0, or PREG_OFFSET_CAPTURE
* @return ~integer The number of matches (false: error)
*/
function cms_preg_match_all_safe(string $pattern, string $subject, ?array &$matches, int $flags = 0)
