(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 ideğ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.