PHP preg_replace()ฟังก์ชั่น
ตัวอย่าง
ใช้นิพจน์ทั่วไปที่ไม่คำนึงถึงขนาดตัวพิมพ์เพื่อแทนที่ Microsoft ด้วย W3Schools ในสตริง:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
ความหมายและการใช้งาน
ฟังก์ชันpreg_replace()
ส่งคืนสตริงหรืออาร์เรย์ของสตริงที่การจับคู่ทั้งหมดของรูปแบบหรือรายการรูปแบบที่พบในอินพุตจะถูกแทนที่ด้วยสตริงย่อย
มีสามวิธีที่แตกต่างกันในการใช้ฟังก์ชันนี้:
1. หนึ่งรูปแบบและสตริงทดแทน การจับคู่ของรูปแบบจะถูกแทนที่ด้วยสตริงการแทนที่
2. อาร์เรย์ของรูปแบบและสตริงการแทนที่ ตรงกับรูปแบบใด ๆ จะถูกแทนที่ด้วยสตริงการแทนที่
3. อาร์เรย์ของรูปแบบและอาร์เรย์ของสตริงการแทนที่ การจับคู่ของแต่ละรูปแบบจะถูกแทนที่ด้วยสตริงการแทนที่ที่ตำแหน่งเดียวกันในอาร์เรย์การแทนที่ หากไม่พบรายการที่ตรงกับตำแหน่งนั้น การจับคู่จะถูกแทนที่ด้วยสตริงว่าง
สตริงการแทนที่อาจมี backreference ในรูปแบบ \n หรือ $n โดยที่ n คือดัชนีของกลุ่มในรูปแบบ ในสตริงที่ส่งคืน อินสแตนซ์ของ \n และ $n จะถูกแทนที่ด้วยสตริงย่อยที่ตรงกับกลุ่ม หรือหากใช้ \0 หรือ $0 โดยนิพจน์ทั้งหมด
หมายเหตุ:สำหรับแต่ละสตริงอินพุต ฟังก์ชันจะประเมินรูปแบบตามลำดับที่กำหนด ผลลัพธ์ของการประเมินรูปแบบแรกบนสตริงนั้นถูกใช้เป็นสตริงอินพุตสำหรับรูปแบบที่สองเป็นต้น นี้สามารถนำไปสู่พฤติกรรมที่ไม่คาดคิด
ไวยากรณ์
preg_replace(patterns, replacements, input, limit, count)
ค่าพารามิเตอร์
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
รายละเอียดทางเทคนิค
คืนมูลค่า: | ส่งกลับสตริงหรืออาร์เรย์ของสตริงที่เกิดจากการใช้การแทนที่กับสตริงอินพุตหรือสตริง |
---|---|
รุ่น PHP: | 4.0.5+ |
บันทึกการเปลี่ยนแปลง: | PHP 5.1.0 - เพิ่มพารามิเตอร์การนับแล้ว |
❮ การอ้างอิง PHP RegExp