preg_quote

preg_quote(string $str, [string $delimiter]): string
```php

`preg_quote` añade una barra invertida antes de cada carácter de la cadena `str` que forma parte de la sintaxis de expresiones regulares. Esto es muy útil si se tiene una cadena que va a servir como máscara, pero que es generada durante la ejecución.

Los caracteres especiales que serán protegidos son los siguientes: `. \ + * ? [ ^ ] $ ( ) { } = ! < > | : - #`

Tenga en cuenta que `/` no es un carácter especial de expresión regular.

> [!NOTE]
> Tenga en cuenta que `preg_quote` no está destinado a ser aplicado a las cadenas \$replacement de `preg_replace` etc.

## Parámetros

`str`  
La cadena de entrada.

`delimiter`  
Si el argumento opcional `delimiter` es proporcionado, también será escapado. Esto es práctico para escapar el delimitador requerido por las funciones PCRE. La barra `/` es el delimitador más común.

## Valores devueltos

Retorna la cadena protegida.

## Historial de cambios

| Versión | Descripción                        |
|---------|------------------------------------|
| 7.3.0   | El carácter `#` ahora es protegido |
| 7.2.0   | `delimiter` ahora es nullable.     |

## Ejemplos

Ejemplo con `preg_quote`

Poner en cursiva una palabra en un texto