Definisi dan Penggunaan
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:
- Satu pola dan satu pengganti. Kecocokan pola diganti dengan string pengganti.
- Sebuah array pola dan string pengganti. Kecocokan salah satu pola diganti dengan string pengganti.
- Sebuah array pola dan array string pengganti. Kecocokan dari setiap pola diganti dengan string pengganti di posisi yang sama dalam array pengganti. Jika tidak ada item yang ditemukan pada posisi itu, kcocokan itu akan diganti dengan string kosong.
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.
Syntax
preg_replace(patterns, replacements, input, limit, count)
Nilai Parameter
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 |
Detail Teknis
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!