Περιγραφή
Η συνάρτηση αυτή επιστρέφει ένα 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 .
Example#1 Παράδειγμα χρήσης της str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Η συνάρτηση αυτή είναι binary safe.
Note: Από την PHP 5.0.0 ο αριθμός των ταιριασμένων και αντικατεστημένων needles θα επιστρέφεται με την παράμετρο count , η οποία θα περνάται με αναφορά. Στις εκδόσεις πριν την PHP 5.0.0 η παράμετρος αυτή δεν είναι διαθέσιμη.
Ανατρέξτε επίσης στις: str_replace(), ereg_replace(), preg_replace(), και strtr().