(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
konu
Samanlı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.