preg_match
La funzione preg_match appartiene alla famiglia delle Funzioni PCRE, dove l'acronimo PCRE sta per Perl Compatible Regular Expression.
Questa funzione viene utilizzata per effettuare dei confronti sulla base di modelli rappresentati sotto forma di espressione regolare.
La funzione preg_match ammette 5 parametri, i primi due sono obbligatori e sono, nell'ordine, il pattern e la stringa in cui cercare. Il terzo parametro, facoltativo, è la definizione di un array dei risultati che sarà destinata a contenere le occorrenze trovate. Quarto e quinto parametro sono, rispettivamente flag e offset: entrambi facoltativi vengono ad avere un'utilità solo in casi particolari, per i quali rimando alla documentazione ufficiale di PHP.
La funzione preg_match restituisce 0 se non vi è nessun riconoscimento, 1 in caso di riconoscimento avvenuto (in questo preg_match differisce da preg_match_all: quest'ultima non si ferma al primo riconoscimento ma continua fino alla fine del parametro testo). In caso di errore preg_match() restituirà FALSE.
Vediamo un esempio di base in cui vengono utilizzati solo i primi due parametri:
<?php
if (preg_match('/mrwebmaster/i', 'MrWebmaster è il mio sito preferito!')) {
echo "Il riconoscimento è avvenuto.";
} else {
echo "Nessun riconoscimento.";
}
?>
Se avessimo voluto estrarre il risultato trovato avremmo inserito il terzo parametro che, lo ricordiamo, è un array:
<?php
if (preg_match('/mrwebmaster/i', 'MrWebmaster è il mio sito preferito!', $risultato)) {
print_r($risultato);
}
?>
