preg_quote
(PHP 4, PHP 5)
preg_quote — Escapar caracteres en una expresión regular
Descripción
$str
[, string $delimiter = NULL
] )
preg_quote() toma string
y pone una barra invertida delante de cada carácter que es parte de
la sintaxis de la expresión regular. Esto es útil si tiene una
cadena en tiempo de ejecución que necesite comparar con algún texto, y la
cadena pueda contener caracteres de expresiones regulares especiales.
Los caracteres de expresiones regulares especiales son: . \ + * ? [ ^ ] $ ( ) { } = ! < > | : -
Parámetros
-
string -
La cadena de entrada.
-
delimiter -
Si se especifica el parámetro opcional
delimiter, éste también será escapado. Esto es útil para escapar el delimitador que es necesario para las funciones PCRE. El delimitador / es el que se usa comúnmente.
Valores devueltos
Devuelve el string entrecomillado (escapado).
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.3.0 | El carácter - ahora es escapado |
Ejemplos
Ejemplo #1 Ejemplo de preg_quote()
<?php
$claves = '$40 por un a g3/400';
$claves = preg_quote($claves, '/');
echo $claves; // devuelve \$40 por un g3\/400
?>
Ejemplo #2 Poner en cursiva una palabra dentro de un texto
<?php
// En este ejemplo, preg_quote($palabra) se usa para que los
// asteriscos sigan teniendo un significado especial en la
// expresión regular.
$texto = "Este libro es *muy* difícil de encontrar.";
$palabra = "*muy*";
$texto = preg_replace ("/" . preg_quote($palabra, '/') . "/",
"<i>" . $palabra . "</i>",
$texto);
?>
Notas
Nota: Esta función es segura binariamente.