Bloque de funciones PREG_FILTER
El bloque de funciones PREG_FILTER busca y reemplaza con expresiones regulares.
Nota: Esta función es Binary-Safe. Esto significa que los caracteres UTF8 no pueden ser procesados directamente.
Aparte del hecho de que el bloque de funciones PREG_FILTER solo devuelve las cadenas de caracteres (posiblemente convertidas) en caso de coincidencias, es idéntico al bloque de funciones PREG_REPLACE.
Entrada PATTERN
La expresión como cadena de caracteres que se busca. También están disponibles algunos modificadores PCRE.
Entrada REPLACEMENT
La cadena de caracteres para reemplazar. Esta puede contener referencias en la forma \n o $n, siendo esta última preferible. 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 una referencia inversa es seguida directamente por otro número (es decir, inmediatamente 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 inversa. Por ejemplo, \11 confundiría a la función porque no sabe si desea la referencia inversa \1 seguida del número 1 o solo la referencia inversa \11. En este caso, la solución es usar ${1}1. Esto crea una referencia inversa aislada $1 y el 1 permanece como un símbolo de letra.
Si usa el modificador obsoleto e, esta función enmascara algunos caracteres (es decir, ', ", \ y NULL) en las cadenas de caracteres con las que se realizarán los reemplazos de referencia inversa. Esto se hace para asegurar que no ocurran errores de sintaxis cuando se usan referencias inversas que contienen comillas simples o dobles. Asegúrese de conocer la sintaxis de las cadenas de caracteres para saber exactamente cómo se verá la cadena de caracteres evaluada.
Entrada SUBJECT
La entrada define la cadena de caracteres a buscar.
Entrada LIMIT
El número máximo posible de reemplazos para cada patrón de búsqueda en cada subject. Valor predeterminado: -1 o NULL (sin límite).
Salida Q
Si se encontraron coincidencias (posiblemente convertidas), se devuelve la nueva cadena de caracteres 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.