(PHP 5, PHP 7, PHP 8)
str_ireplace — Bir alt dizgenin bütün örneklerini yenisiyle değiştirirken harf büyüklüklerini dikkate almaz
$eski,$yeni,$konu,&$sayı = null
Harf büyüklüğüne duyarsız olarak konu dizgesi
içindeki eski dizgelerinin her birini
yeni dizgesiyle değiştirerek elde edilen dizi veya
dizgeyi döndürür.
Metni sabit bir dizge yerine bir kalıba göre değiştirmek için
preg_replace() işlevi i
değiştiricisi
ile kullanılabilir.
Eğer eski ve yeni birer dizi
ise str_replace() her diziden birer değer alıp bunları
kullanarak konu dizgesinde arama ve yer değiştirme
yapar. Eğer yeni dizisi eski
dizisinden daha az değere sahipse eksik kalan yeni dizgelerin yerine boş
dizgeler konur. Eğer eski bir dizi ve
yeni bir dizge ise her eski dizgesinin yerine bu yeni
dizgesi konur. Zıddı anlamlı değildir.
eski ve yeni birer dizi ise,
elemanları baştan sona doğru işlenir.
eskiİğne olarak da bilinen, aranan değer. Birden çok iğneyi belirtmek için bir dizi kullanılabilir.
yeni
Bulunan eski değeriyle değiştirilecek değer.
Çok sayıda yeni belirtmek için dizi kullanılabilir
konuSamanlık olarak da bilinen, eskinin yenisiyle değiştirileceği dizi veya dizge.
konu bir dizi ise, eskiyi yenisi ile değiştirme
işlemi dizinin her elemanına uygulanır ve dönen değer de bir dizi olur.
sayıEğer belirtilirse, değiştirilen dizgelerin sayısı bu bağımsız değişkende döndürülür.
Yer değiştirmeler yapılmış dizge veya dizi döner.
| Sürüm: | Açıklama |
|---|---|
| 8.2.0 | Büyük/küçük harf dönüşümü yalnızca ASCII karakterlere (baytlara) uygulandığından yerelin setlocale() ile atanması artık gerekmiyor. ASCII olmayan karakterlerin bayt değerleri karşılaştırılıyor. |
Örnek 1 - str_ireplace() örneği
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>Bilginize: Bu işlev ikil dosyalarla çalışırken dosya içeriğini değiştirmez.
str_ireplace() yer değiştirmeyi soldan sağa yaptığından, birden çok değiştirme yapılırken yenisi önceden yapılmış bir değişikliği değiştirebilir. str_replace() belgesindeki 2. örnek, bunun uygulamada sizi nasıl etkileyebileceğini gösterir.