Funzione preg_match_all

La funzione preg_match_all esegue una ricerca globale del modello in una stringa. Il primo parametro è l'espressione regolare, il secondo è la stringa in cui cercare, il terzo è l'array per salvare i risultati. Il quarto parametro opzionale definisce la struttura dei dati restituiti, e il quinto parametro opzionale è l'offset di inizio ricerca.

Sintassi

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

Flag

Vediamo quali valori può assumere il quarto parametro:

Parametro	Descrizione
`PREG_PATTERN_ORDER`	Modalità predefinita. I risultati sono raggruppati per gruppo - l'elemento zero dell'array contiene i gruppi zero, il primo elemento dell'array contiene i primi gruppi e così via.
`PREG_SET_ORDER`	I risultati sono raggruppati per corrispondenza - ogni elemento dell'array contiene un array con i gruppi trovati.
`PREG_OFFSET_CAPTURE`	Per ogni corrispondenza viene restituita la posizione nella stringa. Ogni risultato è un array dove l'elemento zero contiene la corrispondenza, e il primo - il suo offset.
`PREG_UNMATCHED_AS_NULL`	I gruppi che non corrispondono vengono restituiti come `null` invece di stringhe vuote.

Esempio

Troviamo tutte le cifre in una stringa:

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

Risultato dell'esecuzione del codice:

['123', '456']

Esempio

Troviamo tutte le lettere 'a' in una stringa:

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

Risultato dell'esecuzione del codice:

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

Esempio

Estraiamo tutti i timestamp dalla stringa e i loro componenti:

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

Risultato dell'esecuzione del codice:

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

Esempio

E ora usiamo il flag PREG_SET_ORDER per raggruppare per corrispondenza:

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

Risultato dell'esecuzione del codice:

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

Vedi anche

la funzione preg_match,
che cerca la prima corrispondenza con un'espressione regolare
la funzione preg_replace,
che esegue ricerca e sostituzione con un'espressione regolare