Συνάρτηση preg_match_all

Η συνάρτηση preg_match_all εκτελεί μια καθολική αναζήτηση προτύπου σε μια συμβολοσειρά. Στην πρώτη παράμετρο περνάται η κανονική έκφραση, στη δεύτερη - η συμβολοσειρά για αναζήτηση, στην τρίτη - ένας πίνακας για αποθήκευση των αποτελεσμάτων. Η τέταρτη προαιρετική παράμετρος καθορίζει τον τύπο της επιστρεφόμενης δομής, και η πέμπτη προαιρετική παράμετρος - τη μετατόπιση έναρξης της αναζήτησης.

Σύνταξη

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

Σημαίες

Ας δούμε ποιες τιμές μπορεί να πάρει η τέταρτη παράμετρος:

Παράμετρος	Περιγραφή
`PREG_PATTERN_ORDER`	Η προεπιλεγμένη λειτουργία. Τα αποτελέσματα ομαδοποιούνται ανά "θαλάμους" (capturing groups) - το μηδενικό στοιχείο του πίνακα περιέχει τους μηδενικούς θαλάμους, το πρώτο στοιχείο του πίνακα περιέχει τους πρώτους θαλάμους και ούτω καθεξής.
`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,
που εκτελεί αναζήτηση και αντικατάσταση με βάση κανονική έκφραση