ฟังก์ชัน preg_match_all

ฟังก์ชัน preg_match_all ดำเนินการค้นหาแบบ global ของแพตเทิร์นในสตริง พารามิเตอร์แรกส่งนิพจน์ปกติ พารามิเตอร์ที่สองส่งสตริงสำหรับค้นหา พารามิเตอร์ที่สามส่งอาร์เรย์สำหรับเก็บผลลัพธ์ พารามิเตอร์ที่สี่ซึ่งเป็นตัวเลือกกำหนดโครงสร้างของข้อมูลที่ส่งกลับ และพารามิเตอร์ที่ห้าซึ่งเป็นตัวเลือกกำหนดจุดเริ่มต้นการค้นหา (offset)

ไวยากรณ์

preg_match_all(pattern, subject, matches, [flags], [offset]);

แฟล็ก

มาดูกันว่าพารามิเตอร์ที่สี่สามารถรับค่าอะไรได้บ้าง:

พารามิเตอร์	คำอธิบาย
`PREG_PATTERN_ORDER`	โหมดเริ่มต้น ผลลัพธ์ถูกจัดกลุ่มตามกลุ่มย่อย (capturing groups) - สมาชิกตัวที่ศูนย์ของอาร์เรย์ประกอบด้วยกลุ่มย่อยที่ศูนย์, สมาชิกตัวที่หนึ่งของอาร์เรย์ประกอบด้วยกลุ่มย่อยที่หนึ่ง และเป็นเช่นนี้เรื่อยไป
`PREG_SET_ORDER`	ผลลัพธ์ถูกจัดกลุ่มตามการค้นพบ - สมาชิกแต่ละตัวของอาร์เรย์ ประกอบด้วยอาร์เรย์ที่มีกลุ่มย่อยที่พบ
`PREG_OFFSET_CAPTURE`	สำหรับแต่ละการค้นพบจะส่งกลับตำแหน่งในสตริงด้วย แต่ละผลลัพธ์แสดงเป็นอาร์เรย์ โดยที่สมาชิกตัวที่ศูนย์ ประกอบด้วยข้อความที่ค้นพบ และตัวที่หนึ่งประกอบด้วยตำแหน่ง (offset) ของมัน
`PREG_UNMATCHED_AS_NULL`	กลุ่มย่อยที่ไม่พบการตรงกันจะถูกส่งกลับเป็น `null` แทนที่จะเป็น สตริงว่าง

ตัวอย่าง

ค้นหาตัวเลขทั้งหมดในสตริง:

<?php
	$str = 'abc 123 def 456';
	preg_match_all('/\d+/', $str, $res);
	var_dump($res[0]);
?>

ผลลัพธ์จากการรันโค้ด:

['123', '456']

ตัวอย่าง

ค้นหาตัวอักษร 'a' ทั้งหมดในสตริง:

<?php
	$str = 'banana';
	preg_match_all('/a/', $str, $res);
	var_dump($res[0]);
?>

ผลลัพธ์จากการรันโค้ด:

['a', 'a', 'a']

ตัวอย่าง

ดึงข้อมูลเวลาทั้งหมดจากสตริงและส่วนประกอบของมัน:

<?php
	$time = '12:01:02 13:03:04 14:05:06';
	preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res);
	var_dump($res);
?>

ผลลัพธ์จากการรันโค้ด:

[
	0 => ['12:01:02', '13:03:04', '14:05:06'],
	1 => ['12', '13', '14'],
	2 => ['01', '03', '05'],
	3 => ['02', '04', '06']
]

ตัวอย่าง

คราวนี้มาใช้แฟล็ก PREG_SET_ORDER สำหรับจัดกลุ่มตามการค้นพบ:

<?php
	$time = '12:01:02 13:03:04 14:05:06';
	preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res, PREG_SET_ORDER);
	var_dump($res);
?>

ผลลัพธ์จากการรันโค้ด:

[
	0 => '12:01:02',
	1 => '12',
	2 => '01',
	3 => '02'
],
[
	0 => '13:03:04',
	1 => '13',
	2 => '03',
	3 => '04'
],
[
	0 => '14:05:06',
	1 => '14',
	2 => '05',
	3 => '06'
]

ดูเพิ่มเติม

ฟังก์ชัน preg_match,
ซึ่งค้นหาการตรงกันครั้งแรกกับนิพจน์ปกติ
ฟังก์ชัน preg_replace,
ซึ่งดำเนินการค้นหาและแทนที่ตามนิพจน์ปกติ