Fungsi preg_replace()
digunakan untuk dapat mengembalikan string atau array string di mana semua kecocokan pola atau daftar pola yang ditemukan dalam masukan diganti dengan substring.
Ada tiga cara berbeda untuk menggunakan fungsi ini:
String pengganti mungkin berisi latar referensi dalam bentuk \n atau $n di mana n adalah indeks grup dalam pola. Dalam string yang dikembalikan, instance \n dan $n akan diganti dengan substring yang cocok dengan grup atau jika \0 atau $0 akan digunakan oleh seluruh ekspresi.
Catatan: Untuk setiap string masukan, fungsi mengevaluasi pola dalam urutan yang diberikan. Hasil evaluasi pola pertama pada string digunakan sebagai input string untuk pola kedua dan seterusnya. Ini dapat menyebabkan perilaku yang tidak terduga.
preg_replace(patterns, replacements, input, limit, count)
Parameter | Deskripsi |
---|---|
patterns | Required. Berisi ekspresi reguler atau ekspresi reguler array |
replacements | Required. String pengganti atau array string pengganti |
input | Required. String atau array string tempat penggantian dilakukan |
limit | Optional. Default-nya -1, artinya tidak terbatas. Menetapkan batas berapa banyak penggantian yang dapat dilakukan di setiap string |
count | Optional. Setelah fungsi dijalankan, variabel ini akan berisi angka yang menunjukkan berapa banyak penggantian yang dilakukan |
Return Value: | Mengembalikan string atau array string yang dihasilkan dari penerapan penggantian ke string input atau string |
---|---|
PHP Version: | 4.0.5+ |
Changelog: | PHP 5.1.0 – Parameter count telah ditambahkan |
Contoh
Gunakan ekspresi reguler peka huruf besar-kecil untuk menggantikan Google dengan DosenIT dalam string:
<?php $str = 'Kunjungi Google!'; $pattern = '/google/i'; echo preg_replace($pattern, 'DosenIT', $str); ?> // Output : Kunjungi DosenIT!