Funksiya preg_match_all

Funksiya preg_match_all sətirdə şablonun qlobal axtarışını yerinə yetirir. Birinci parametrə regulyar ifadə, ikinciyə - axtarış üçün sətir, üçüncüyə - nəticələrin saxlanması üçün massiv ötürülür. Dördüncü isteğe bağlı parametr qaytarılan strukturun tipini, beşinci isteğe bağlı parametr isə axtarışın başlanğıc ofsetini təyin edir.

Sintaksis

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

Bayraqlar

Gəlin dördüncü parametrin hansı dəyərləri ala biləcəyinə baxaq:

Parametr	Təsvir
`PREG_PATTERN_ORDER`	Susmaya görə rejim. Nəticələr qruplar üzrə qruplaşdırılır - massivin sıfır elementi sıfır qrupları ehtiva edir, birinci element massivi birinci qrupları ehtiva edir və s.
`PREG_SET_ORDER`	Nəticələr uyğunluqlar üzrə qruplaşdırılır - massivin hər bir elementi tapılan qrupları ehtiva edən massivdən ibarətdir.
`PREG_OFFSET_CAPTURE`	Hər bir uyğunluq üçün sətirdəki mövqe qaytarılır. Hər bir nəticə, sıfır elementinin uyğunluğu, birincinin isə onun ofsetini ehtiva etdiyi massivdir.
`PREG_UNMATCHED_AS_NULL`	Uyğun gəlməyən qruplar boş sətirlər əvəzinə `null` kimi qaytarılır.

Nümunə

Sətirdəki bütün rəqəmləri tapaq:

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

Kodun icrasının nəticəsi:

['123', '456']

Nümunə

Sətirdəki bütün 'a' hərflərini tapaq:

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

Kodun icrasının nəticəsi:

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

Nümunə

Sətirdən bütün zaman qeydlərini və onların komponentlərini çıxaraq:

<?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);
?>

Kodun icrasının nəticəsi:

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

Nümunə

İndi isə uyğunluqlar üzrə qruplaşdırmaq üçün PREG_SET_ORDER bayrağından istifadə edək:

<?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);
?>

Kodun icrasının nəticəsi:

[
	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'
]

Həmçinin bax

funksiyası preg_match,
regulyar ifadə ilə ilk uyğunluğu axtarır
funksiyası preg_replace,
regulyar ifadə ilə axtarış və əvəzetməni yerinə yetirir