Μονάδα Λειτουργίας PREG_FILTER

Η Μονάδα Λειτουργίας PREG_FILTER αναζητά και αντικαθιστά με κανονικές εκφράσεις.

Σημείωση: Αυτή η λειτουργία είναι Binary-Safe. Αυτό σημαίνει ότι τα UTF8 χαρακτήρες δεν μπορούν να επεξεργαστούν απευθείας.

Εκτός από το γεγονός ότι η Μονάδα Λειτουργίας PREG_FILTER επιστρέφει μόνο σε περίπτωση ταιριάσματος τις (πιθανώς μετατρεπόμενες) αλυσίδες χαρακτήρων, είναι πανομοιότυπη με τη Μονάδα Λειτουργίας PREG_REPLACE.

Είσοδος PATTERN

Η έκφραση ως αλυσίδα χαρακτήρων που αναζητάται. Υπάρχουν επίσης μερικοί τροποποιητές PCRE διαθέσιμοι.

Είσοδος REPLACEMENT

Η αλυσίδα χαρακτήρων για αντικατάσταση. Αυτή μπορεί να περιέχει αναφορές στη μορφή \n ή $n, όπου η τελευταία προτιμάται. Κάθε μία από αυτές τις αναφορές αντικαθίσταται με τον κείμενο που καταγράφεται από το n-οστό εγκλωβισμένο μοτίβο αναζήτησης. Το n μπορεί να έχει τιμή από 0 έως 99. \0 ή $0 αναφέρονται στον κείμενο που ταιριάζει στο πλήρες μοτίβο αναζήτησης. Για να λάβετε τον αριθμό του εγκλωβισμένου υπομοτίβου αναζήτησης, οι ανοιγόμενες παρενθέσεις μετρώνται από 1 ξεκινώντας από αριστερά προς τα δεξιά. Για να χρησιμοποιήσετε ένα αντίστροφο διαγώνιο στην αντικατάσταση, πρέπει να το διπλασιάσετε "\\".

Αν θέλετε να εργαστείτε με μια αντικατάσταση όπου ακολουθεί άμεσα μια αναφορά σε ένα άλλο αριθμό (δηλαδή, αμέσως μετά το ταιριασμό ενός μοτίβου αναζήτησης πρέπει να έρθει ένας αριθμός), δεν μπορείτε να χρησιμοποιήσετε τη μορφή \1 για την αναφορά σας. Για παράδειγμα, το \11 θα συγχέει τη λειτουργία, επειδή δεν ξέρει αν θέλετε την αναφορά \1 ακολουθούμενη από τον αριθμό 1 ή μόνο την αναφορά \11. Σε αυτήν την περίπτωση, η λύση είναι να χρησιμοποιήσετε ${1}1. Αυτό δημιουργεί μια απομονωμένη αναφορά $1 και το 1 παραμένει ένα σύμβολο χαρακτήρα.

Αν χρησιμοποιήσετε τον πρεβιακό τροποποιητή e, αυτή η λειτουργία μασκάρει μερικούς χαρακτήρες (δηλαδή ', ", \ και NULL) στις αλυσίδες χαρακτήρων με τις οποίες αντικαθίστανται οι αναφορές. Αυτό γίνεται για να εξασφαλιστεί ότι δεν προκύπτουν σφάλματα σύνταξης όταν χρησιμοποιούνται αναφορές που περιέχουν απλά ή διπλά εισαγωγικά. Βεβαιωθείτε ότι γνωρίζετε τη σύνταξη αλυσίδας χαρακτήρων για να ξέρετε ακριβώς πώς φαίνεται η αξιολογημένη αλυσίδα.

Είσοδος SUBJECT

Η είσοδος ορίζει την αλυσίδα χαρακτήρων που θα αναζητηθεί.

Είσοδος LIMIT

Ο μέγιστος δυνατός αριθμός αντικαταστάσεων για κάθε μοτίβο σε κάθε subject. Προκαθορισμένη τιμή: -1 ή NULL (χωρίς όριο).

Έξοδος Q

Αν βρεθούν ταιριάσματα (πιθανώς μετατρεπόμενα), επιστρέφεται η νέα αλυσίδα χαρακτήρων Q, διαφορετικά επιστρέφεται το SUBJECT αμετάβλητο ή NULL, αν συνέβη κάποιο σφάλμα.

Έξοδος COUNT

Ο έξοδος επιστρέφει τον αριθμό των πραγματοποιημένων αντικαταστάσεων.