Η συνάρτηση αυτή επιστρέφει ένα string ή έναν πίνακα, στον οποίο η κάθε εμφάνιση της παραμέτρου
search
στο string subject
(ignoring case) έχει αντικατασταθεί από την τιμή replace
. Εάν δε θέλετε περίπλοκους κανόνες αντικατάστασης, θα πρέπει να χρησιμοποιείται αυτή τη συνάρτηση αντί της eregi_replace() ή της preg_replace() με τον modifier i.
Εάν η παράμετρος subject
είναι ένας πίνακας, τότε η έρευνα και η αντικατάσταση υλοποιούνται με κάθε στοιχείο του subject
, και η επιστρεφόμενη τιμή είναι ένας πίνακας.
Εάν οι παράμετροι search
και replace
είναι πίνακες, τότε η συνάρτηση str_ireplace() πέρνει μία τιμή από κάθε πίνακα και τη χρησιμοποιεί για έρευνα και αντικατάσταση επί του subject
. Εάν ο πίνακας replace
έχει λιγότερες τιμές από τον search
, τότε χρησιμοποιείται ένα κενό string για τις υπόλοιπες τιμές αντικατάστασης. Εάν η search
είναι ένας πίνακας και η replace
ένα string, τότε αυτό το string αντικατάστασης χρησιμοποιείται για κάθε τιμή του search
.
Η συνάρτηση αυτή είναι binary safe.
Óçìåßùóç: Από την PHP 5.0.0 ο αριθμός των ταιριασμένων και αντικατεστημένων
needles
θα επιστρέφεται με την παράμετροcount
, η οποία θα περνάται με αναφορά. Στις εκδόσεις πριν την PHP 5.0.0 η παράμετρος αυτή δεν είναι διαθέσιμη.
Ανατρέξτε επίσης στις: str_replace(), ereg_replace(), preg_replace(), και strtr().