Definisi dan Penggunaan
Fungsi str_ireplace() digunakan untuk menggantikan beberapa karakter dengan beberapa karakter lain dalam sebuah string.
Fungsi ini berfungsi dengan aturan berikut:
- Jika string yang akan dicari adalah array, ia mengembalikan sebuah array
- Jika string yang akan dicari adalah array, pencarian dan penggantian dilakukan dengan setiap elemen array
- Jika find dan replace adalah array dan replace memiliki elemen yang lebih sedikit daripada find, string kosong akan digunakan sebagai replace
- Jika find adalah array dan replace adalah string, string replace akan digunakan untuk setiap nilai yang ditemukan
Catatan: Fungsi ini tidak peka huruf besar kecil(case-insensitive). Gunakan fungsi str_replace() untuk melakukan pencarian case-sensitive.
Catatan: Fungsi ini binary-safe.
Syntax
str_ireplace(find,replace,string,count)
Nilai Parameter
| Parameter | Deskripsi |
|---|---|
| find | Required. Menentukan nilai untuk ditemukan |
| replace | Required. Menentukan nilai untuk menggantikan nilai dalam pencarian |
| string | Required. Menentukan string yang akan dicari |
| count | Optional. Variabel yang menghitung jumlah penggantian |
Detail Teknis
| Return Value: | Mengembalikan string atau array dengan nilai yang diganti |
|---|---|
| PHP Version: | 5+ |
| Changelog: | Parameter count ditambahkan di PHP 5.0 |
Contoh 1
Ganti karakter “WORLD” (case-insensitive) dalam string “Hello world!” dengan “Peter”:
<?php echo str_ireplace("WORLD","Parker","Hello world!"); ?> // Output : Hello Parker!
Contoh 2
Menggunakan str_ireplace () dengan array dan variabel count:
<?php
$arr = array("biru","merah","hijau","kuning");
print_r(str_ireplace("MERAH","PINK",$arr,$i)); // Fungsi ini tidk peka huruf besar / kecil
echo "Replacements: $i";
?>
/* Output :
Array ( [0] => biru [1] => pink [2] => hijau [3] => kuning )
Replacements: 1
Contoh 3
Menggunakan str_ireplace() dengan elemen yang lebih sedikit di replace daripada find:
<?php
$find = array("HELLO","WORLD");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_ireplace($find,$replace,$arr));
?>
/* Output :
Array ( [0] => B [1] => [2] => ! )