
Η Μονάδα Λειτουργίας PREG_REPLACE αναζητά και αντικαθιστά με κανονικές εκφράσεις.
Σημείωση: Αυτή η λειτουργία είναι Binary-Safe. Αυτό σημαίνει ότι τα UTF8 χαρακτήρες δεν μπορούν να επεξεργαστούν απευθείας.
Η έκφραση ως συμβολοσειρά, για την οποία γίνεται αναζήτηση. Υπάρχουν επίσης μερικοί τροποποιητές PCRE διαθέσιμοι.
Η συμβολοσειρά για αντικατάσταση. Αυτή μπορεί να περιέχει αναφορές στη μορφή \n ή $n, όπου η τελευταία προτιμάται. Κάθε μία από αυτές τις αναφορές αντικαθίσταται με τον κείμενο που καταγράφεται από το n-οστό εγκλωβισμένο μοτίβο αναζήτησης. Το n μπορεί να έχει τιμή από 0 έως 99. \0 ή $0 αναφέρονται στο κείμενο που ταιριάζει με το πλήρες μοτίβο αναζήτησης. Για να λάβετε τον αριθμό του εγκλωβισμένου υπομοτίβου αναζήτησης, οι ανοιγόμενες παρενθέσεις μετρώνται από 1 ξεκινώντας από αριστερά προς τα δεξιά. Για να χρησιμοποιήσετε μια αντίστροφη διαφάνεια στην αντικατάσταση, πρέπει να την διπλασιάσετε "\\".
Αν θέλετε να εργαστείτε με μια αντικατάσταση όπου ακολουθεί μια άλλη αριθμητική τιμή αμέσως μετά από μια αναφορά (δηλαδή, αμέσως μετά την ταιριάξτε με ένα μοτίβο αναζήτησης πρέπει να έρθει ένας αριθμός), δεν μπορείτε να χρησιμοποιήσετε τη μορφή γραφής \1 για την αναφορά σας. Για παράδειγμα, το \11 θα συγχέει τη λειτουργία, επειδή δεν ξέρει αν θέλετε την αναφορά \1 ακολουθούμενη από τον αριθμό 1 ή μόνο την αναφορά \11. Σε αυτήν την περίπτωση, η λύση είναι να χρησιμοποιήσετε ${1}1. Αυτό δημιουργεί μια απομονωμένη αναφορά $1 και η 1 παραμένει ένα σύμβολο χαρακτήρα.
Αν χρησιμοποιήσετε τον πρεβιακό τροποποιητή e, αυτή η λειτουργία μασκαρεύει μερικούς χαρακτήρες (δηλαδή ', ", \ και NULL) στις συμβολοσειρές με τις οποίες αντικαθίστανται οι αναφορές. Αυτό γίνεται για να εξασφαλιστεί ότι δεν προκύπτουν σφάλματα σύνταξης όταν χρησιμοποιούνται αναφορές που περιέχουν απλά ή διπλά εισαγωγικά. Βεβαιωθείτε ότι γνωρίζετε τη σύνταξη συμβολοσειρών για να ξέρετε ακριβώς πώς φαίνεται η αξιολογημένη συμβολοσειρά.
Η είσοδος ορίζει την συμβολοσειρά για αναζήτηση.
Ο μέγιστος δυνατός αριθμός αντικαταστάσεων για κάθε μοτίβο σε κάθε subject. Προκαθορισμένη τιμή: -1 ή NULL (χωρίς όριο).
Αν βρεθούν ταιριάσματα, επιστρέφεται η νέα συμβολοσειρά Q, διαφορετικά επιστρέφεται το SUBJECT αμετάβλητο ή NULL, αν συνέβη ένα σφάλμα.
Ο έξοδος επιστρέφει τον αριθμό των πραγματοποιημένων αντικαταστάσεων.