
PREG_REPLACE İş Bloku, düzenli ifadelerle arama ve değiştirme işlemleri gerçekleştirir.
Not: Bu fonksiyon Binary-Safe'dir. Bu, UTF8 karakterlerinin doğrudan işlenemeyeceği anlamına gelir.
Aranacak ifade olarak dize. Bazı PCRE değiştiricileri de kullanılabilir.
Değiştirmek için kullanılan dize. Bu, \n veya $n şeklindeki referanslar içerebilir, sonuncusu tercih edilir. Her bir bu referans, n'inci parantezli arama deseni tarafından yakalanan metinle değiştirilir. n, 0 ile 99 arasında bir değere sahip olabilir. \0 veya $0, tam arama deseniyle eşleşen metine atıfta bulunur. Yakalanan alt-arama deseninin numarasını elde etmek için açılış parantezleri, soldan sağa doğru 1'den başlayarak sayılır. Değiştirmede ters slayş kullanmak için çiftleştirilmelidir "\\".
Eğer bir değiştirme işlemi yapmak istiyorsunuz ve bir geri referansın hemen ardından bir sayı geliyor (yani, bir arama deseniyle eşleşmenin hemen ardından bir sayı gelmeliyse), \1 yazımını geri referanslama için kullanamazsınız. Örneğin, \11, fonksiyonu karıştıracaktır çünkü bilmez, \1 geri referanslamasını istiyor musunuz ve ardından sayı 1, veya sadece geri referanslama \11. Bu durumda çözüm, ${1}1 kullanmaktır. Böylece bir izole geri referanslama $1 oluşturulur ve 1, bir harf sembolü olarak kalır.
Eğer eski e değiştiriciyi kullanıyorsanız, bu fonksiyon, geri referanslamalarla değiştirilecek dizelerdeki bazı karakterleri (yani ', ", \ ve NULL) maskeler. Bu, geri referanslamalar kullanıldığında basit veya çift tırnak içeren karakterler nedeniyle syntax hataları oluşmasını önlemek için yapılır. Dizelerin syntaxını bilmeniz gerekiyor ki, değerlendirilen dize nasıl göründüğünü tam olarak bilelim.
Giriş, aranacak dizeyi tanımlar.
Her subject için her arama desenine uygulanabilecek en fazla değiştirme sayısı. Varsayılan değer: -1 veya NULL (sınır yok).
Eğer eşleşmeler bulunursa, yeni dize Q döndürülür, aksi takdirde SUBJECT değiştirilmeden döndürülür veya NULL, bir hata oluştuysa.
Çıktı, yapılan değiştirme sayısını döndürür.