Blocco Funzionale PREG_FILTER
Il blocco funzionale PREG_FILTER cerca e sostituisce con espressioni regolari.
Nota: Questa funzione è Binary-Safe. Ciò significa che i caratteri UTF8 non possono essere elaborati direttamente.
A parte il fatto che il blocco funzionale PREG_FILTER restituisce solo le stringhe di caratteri (possibilmente convertite) in caso di corrispondenze, è identico al blocco funzionale PREG_REPLACE.
Ingresso PATTERN
L'espressione come stringa di caratteri da cercare. Sono disponibili anche alcuni modificatori PCRE.
Ingresso REPLACEMENT
La stringa di caratteri per la sostituzione. Questa può contenere riferimenti nella forma \n o $n, quest'ultima è preferibile. Ogni riferimento viene sostituito con il testo catturato dal n-esimo pattern di ricerca tra parentesi. n può avere un valore da 0 a 99. \0 o $0 si riferiscono al testo che corrisponde all'intero pattern di ricerca. Per ottenere il numero del pattern di ricerca parziale catturante, le parentesi aperte vengono contate a partire da sinistra verso destra con 1. Per utilizzare una barra rovesciata nella sostituzione, deve essere raddoppiata "\\".
Se si desidera lavorare con una sostituzione in cui a un riferimento segue direttamente un altro numero (cioè, subito dopo la corrispondenza con un pattern di ricerca dovrebbe esserci un numero), non è possibile utilizzare la notazione \1 per il proprio riferimento. Ad esempio, \11 confonderebbe la funzione perché non sa se si desidera il riferimento \1 seguito dal numero 1 o solo il riferimento \11. In questo caso, la soluzione è utilizzare ${1}1. Questo crea un riferimento isolato $1 e il 1 rimane un simbolo di lettera.
Se si utilizza il modificatore obsoleto e, questa funzione maschera alcuni caratteri (cioè ', ", \ e NULL) nelle stringhe di caratteri con cui i riferimenti verranno sostituiti. Questo viene fatto per garantire che non si verifichino errori di sintassi quando vengono utilizzati riferimenti che contengono virgolette singole o doppie. Assicurarsi di conoscere la sintassi delle stringhe di caratteri per sapere esattamente come appare la stringa di caratteri valutata.
Ingresso SUBJECT
L'ingresso definisce la stringa di caratteri da cercare.
Ingresso LIMIT
Il numero massimo possibile di sostituzioni per ogni pattern di ricerca in ogni subject. Valore predefinito: -1 o NULL (nessun limite).
Uscita Q
Se sono state trovate corrispondenze (possibilmente convertite), viene restituita la nuova stringa di caratteri Q, altrimenti viene restituito SUBJECT inalterato o NULL, se si è verificato un errore.
Uscita COUNT
L'uscita restituisce il numero di sostituzioni effettuate.