preg_match_all функциясы

preg_match_all функциясы жолдағы үлгіні жаһандық түрде іздейді. Бірінші параметрге регулярды өрнек, екіншіге - іздеу жолы, үшіншіге - нәтижелерді сақтау үшін массив беріледі. Төртінші міндетті емес параметр қайтарылатын құрылымның түрін анықтайды, ал бесінші міндетті емес параметр - іздеудің басталу ығысуын көрсетеді.

Синтаксис

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

Флагтар

Төртінші параметр қандай мәндерді қабылдай алатынын қарастырайық:

Параметр	Сипаттама
`PREG_PATTERN_ORDER`	Әдепкі режім. Нәтижелер кармандар бойынша топтастырылады - массивтің нөлдік элементі нөлдік кармандарды қамтиды, бірінші элемент бірінші кармандарды қамтиды және т.с.с.
`PREG_SET_ORDER`	Нәтижелер сәйкестіктер бойынша топтастырылады - әрбір массив элементі табылған кармандары бар массивті қамтиды.
`PREG_OFFSET_CAPTURE`	Әрбір сәйкестік үшін жолдағы орны қайтарылады. Әрбір нәтиде - бұл нөлдік элементі сәйкестікті, ал біріншісі - оның ығысуын қамтитын массив.
`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 функциясы,
ол регулярды өрнек бойынша іздеу және ауыстыруды орындайды