Blocco funzionale PREG_REPLACE
Il blocco funzionale PREG_REPLACE cerca e sostituisce con espressioni regolari.
Nota: Questa funzione è Binary-Safe. Ciò significa che i caratteri UTF8 non possono essere elaborati direttamente.
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. 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 sotto-pattern di cattura, 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 un riferimento segue direttamente un altro numero (cioè, subito dopo la corrispondenza con un pattern di ricerca deve venire 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 vengono sostituiti. Questo viene fatto per garantire che non si verifichino errori di sintassi quando si utilizzano riferimenti che contengono virgolette singole o doppie. Assicurarsi di conoscere la sintassi delle stringhe di caratteri per sapere esattamente come appare la stringa 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, 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.