Η συνάρτηση αυτή επιστρέφει ένα 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().