ფუნქცია 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,
რომელიც ასრულებს ძიებას და ჩანაცვლებას რეგულარული გამოსახულების მიხედვით