e544ed6d9a
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1 It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0. Remark: During tests with Smarty 4.5.1, it was noticed that the following warning occurs: Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier. As of Smarty 5.X.X, templates must be revised again. The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
# regex_replace
|
|
|
|
A regular expression search and replace on a variable. Use the
|
|
[`preg_replace()`](https://www.php.net/preg_replace) syntax from the PHP
|
|
manual.
|
|
|
|
## Basic usage
|
|
```smarty
|
|
{$myVar|regex_replace:"/foo/":"bar"}
|
|
```
|
|
|
|
> **Note**
|
|
>
|
|
> Although Smarty supplies this regex convenience modifier, it is
|
|
> usually better to apply regular expressions in PHP, either via custom
|
|
> functions or modifiers. Regular expressions are considered application
|
|
> code and are not part of presentation logic.
|
|
|
|
## Parameters
|
|
|
|
| Parameter Position | Type | Required | Description |
|
|
|--------------------|--------|----------|------------------------------------------------|
|
|
| 1 | string | Yes | This is the regular expression to be replaced. |
|
|
| 2 | string | Yes | This is the string of text to replace with. |
|
|
|
|
|
|
## Examples
|
|
|
|
```php
|
|
<?php
|
|
|
|
$smarty->assign('articleTitle', "Infertility unlikely to\nbe passed on, experts say.");
|
|
|
|
```
|
|
|
|
Where template is:
|
|
|
|
```smarty
|
|
{* replace each carriage return, tab and new line with a space *}
|
|
|
|
{$articleTitle}
|
|
{$articleTitle|regex_replace:"/[\r\t\n]/":" "}
|
|
```
|
|
|
|
Will output:
|
|
|
|
```
|
|
Infertility unlikely to
|
|
be passed on, experts say.
|
|
Infertility unlikely to be passed on, experts say.
|
|
```
|
|
|
|
|
|
See also [`replace`](language-modifier-replace.md) and
|
|
[`escape`](language-modifier-escape.md).
|