Bloque de funciones PREG_REPLACE
El bloque de funciones PREG_REPLACE busca y reemplaza con expresiones regulares.
Nota: Esta función es Binary-Safe. Esto significa que los caracteres UTF8 no pueden ser manipulados directamente.
Entrada PATTERN
La expresión como cadena de texto, según la cual se busca. También están disponibles algunos modificadores PCRE.
Entrada REPLACEMENT
La cadena de texto para reemplazar. Esta puede contener referencias en forma de \n o $n, siendo preferible esta última. Cada una de estas referencias se reemplaza con el texto capturado por el patrón de búsqueda n-ésimo. n puede tener un valor de 0 a 99. \0 o $0 se refieren al texto que coincide con el patrón de búsqueda completo. Para obtener el número del subpatrón de captura, las paréntesis abiertos se cuentan comenzando desde la izquierda hacia la derecha a partir de 1. Para usar una barra invertida en el reemplazo, debe duplicarse "\\".
Si desea trabajar con un reemplazo en el que a una referencia de retorno le sigue directamente otro número (es decir, después de la coincidencia con un patrón de búsqueda debe venir un número), no puede usar la notación \1 para su referencia de retorno. Por ejemplo, \11 confundiría a la función porque no sabe si desea la referencia de retorno \1 seguida del número 1 o solo la referencia de retorno \11. En este caso, la solución es usar ${1}1. Esto genera una referencia de retorno aislada $1 y el 1 sigue siendo un símbolo de letra.
Si usa el modificador obsoleto e, esta función enmascara algunos caracteres (a saber, ', ", \ y NULL) en las cadenas de texto con las que se reemplazarán las referencias de retorno. Esto se hace para garantizar que no ocurran errores de sintaxis cuando se usan referencias de retorno que contienen comillas simples o dobles. Asegúrese de conocer la sintaxis de cadena de texto para saber exactamente cómo se verá la cadena de texto evaluada.
Entrada SUBJECT
La entrada define la cadena de texto a buscar.
Entrada LIMIT
El número máximo posible de reemplazos para cada patrón en cada subject. Valor predeterminado: -1 o NULL (sin límite).
Salida Q
Si se encontraron coincidencias, se devuelve la nueva cadena de texto Q; de lo contrario, se devuelve SUBJECT sin cambios o NULL, si ocurrió un error.
Salida COUNT
La salida devuelve el número de reemplazos realizados.