
ฟังก์ชันบล็อก PREG_REPLACE ค้นหาและแทนที่ด้วยการใช้ตัวดำเนินการปกติ.
หมายเหตุ: ฟังก์ชันนี้เป็น Binary-Safe. หมายความว่า UTF8-ตัวอักษรไม่สามารถแก้ไขได้โดยตรง
การแสดงผลของสตริงที่ค้นหา มี PCRE-Modifikatoren ที่ใช้งานได้บางส่วน.
สตริงสำหรับการแทนที่ สามารถมีการอ้างอิงในรูปแบบ \n หรือ $n ซึ่งหลังนี้ควรจะใช้งานมากกว่า การอ้างอิงเหล่านี้จะถูกแทนที่ด้วยข้อความที่จับได้จาก n-พัทธ์ของการค้นหา n สามารถมีค่าระหว่าง 0 ถึง 99 \0 หรือ $0 อ้างอิงถึงข้อความที่ตรงกับการค้นหาทั้งหมด เพื่อให้ได้หมายเลขของพัทธ์การจับกุม การเปิดวงเล็บจะถูกนับจากซ้ายไปขวาเริ่มต้นที่ 1 เพื่อใช้แบ็กสแลชในการแทนที่ต้องทำให้เป็นสองเท่า "\\".
ถ้าคุณต้องการทำงานกับการแทนที่ซึ่งมีตัวเลขตามหลังการอ้างอิงกลับ (คือ หลังจากตรงกับพัทธ์การค้นหา ต้องมีตัวเลข) คุณไม่สามารถใช้รูปแบบการเขียน \1 สำหรับการอ้างอิงกลับของคุณได้ เช่น \11 จะทำให้ฟังก์ชันสับสน เพราะมันไม่รู้ว่าคุณต้องการการอ้างอิงกลับ \1 ตามด้วยตัวเลข 1 หรือเพียงแค่การอ้างอิงกลับ \11 ในกรณีนี้ การแก้ไขคือใช้ ${1}1 ด้วยการนี้จะสร้างการอ้างอิงกลับที่แยกต่างหาก $1 และ 1 จะเป็นตัวอักษร
ถ้าคุณใช้ Modifikator ที่เก่าแก่ e ฟังก์ชันนี้จะทำการปิดบังตัวอักษรบางตัว (คือ ', ", \ และ NULL) ในสตริงที่ใช้แทนที่การอ้างอิงกลับ เพื่อให้แน่ใจว่าจะไม่มีข้อผิดพลาดในการเขียนโปรแกรมเมื่อใช้งานการอ้างอิงกลับที่มีเครื่องหมายจับคู่เดี่ยวหรือสองชั้น ตรวจสอบให้แน่ใจว่า คุณทราบถึงการใช้งานของสตริงเพื่อทราบว่าสตริงที่ถูกประเมินจะดูอย่างไร
อินพุตนี้กำหนดสตริงที่จะค้นหา.
จำนวนการแทนที่สูงสุดที่เป็นไปได้สำหรับแต่ละพัทธ์ในแต่ละ subject ค่าฐานคือ -1 หรือ NULL (ไม่มีการจำกัด).
ถ้ามีการตรงกันจะคืนสตริงใหม่ Q ถ้าไม่มีการตรงกันจะคืน SUBJECT ไปโดยไม่เปลี่ยนแปลง หรือ NULL หากเกิดข้อผิดพลาด.
เอาท์พุตนี้คืนจำนวนการแทนที่ที่ทำแล้ว.