(PHP 3 >= 3.0.6, PHP 4, PHP 5)
str_replace -- Αντικατάσταση όλων των εμφανίσεων του search string από το replace stringΗ συνάρτηση αυτή επιστρέφει ένα string ή έναν πίνακα, όπου όλες οι εμφανίσεις του search string στο subject string έχουν αντικατασταθεί από τη δοσμένη τιμή replace. Εάν δεν επιθυμείτε περίπλοκους κανόνες αντικατάστασης, θα πρέπει να χρησιμοποιείτε αυτή τη συνάρτηση αντί της ereg_replace() ή της preg_replace().
Από την PHP 4.0.5, κάθε παράμετρος της συνάρτησης str_replace() μπορεί να είναι πίνακας.
Ðñïåéäïðïßçóç |
Στις εκδόσεις της PHP πριν την 4.3.3 υπήρχε ένα bug όταν γινόταν χρήση πινάκων για τις παραμέτρους search και replace, λόγω του οποίου οι κενοί δείκτες του search προσπερνιόντουσαν χωρίς να υπάρχει αντίστοιχη αύξηση στον εσωτερικό δείκτη του πίνακα replace. Αυτό διορθώθηκε στην PHP 4.3.3, οποιαδήποτε scripts βασίζονταν σε αυτό το bug θα πρέπει να αφαιρούν τις κενές τιμές search πριν την κλήση αυτής της συνάρτησης προκειμένου να υπάρχει προσομοίωση της κανονικής συμπεριφοράς. |
Εάν η παράμετρος subject είναι ένας πίνακας, τότε η έρευνα και η αντικατάσταση εκτελείται για κάθε στοιχείο του subject, και η επιστρεφόμενη τιμή είναι επίσης πίνακας.
Εάν η παράμετροι search και replace είναι πίνακες, τότε η συνάρτηση str_replace() παίρνει μία τιμή από κάθε πίνακα και τις χρησιμοποιεί για έρευνα και αντικατάσταση στον πίνακα subject. Εάν η replace έχει λιγότερες τιμές από την search, τότε χρησιμοποιείται ένα κενό string για τις υπόλοιπες τιμές αντικατάστασης. Εάν η search είναι ένας πίνακας και η replace ένα string, τότε χρησιμοποιείται αυτό το string για κάθε τιμή του search.
Óçìåßùóç: Αυτή η συνάρτηση είναι binary-safe.
Óçìåßùóç: Από την PHP 5.0.0 ο αριθμός των ταιριασμένων και αντικατεστημένων needles θα δίνεται από την παράμετρο count η αποία περνάται κατ' αναφορά. Πριν την PHP 5.0.0 αυτή η παράμετρος δεν είναι διαθέσιμη.
Ανατρέξτε επίσης στις: str_ireplace(), substr_replace(), ereg_replace(), preg_replace(), και strtr().