preg_quote

(PHP 4, PHP 5, PHP 7, PHP 8)

preg_quoteInserisce il carattere di escape nei caratteri delle espressioni regolari

Descrizione

preg_quote(string $stringa, string $delimitatori = ?): string

La funzione preg_quote() inserisce il carattere di escape (\) davanti ad ogni carattere presente in stringa che sia parte della sintassi di una espressione regolare. Questa funzione è utile nei casi in cui si generino, durante l'esecuzione, delle stringhe da usare come criteri di riconoscimento, e queste possano contenere dei caratteri speciali per le espressioni regolari.

Se viene specificato un carattere come parametro delimitatore, anche a questo sarà anteposto il carattere di escape (\). Ciò è particolarmente utile per porre il carattere di escape nei delimitatori richiesti dalle funzioni PCRE. Il carattere di delimitazione più comunemente utilizzato è /.

I caratteri speciali per le espressioni regolari sono: . \\ + * ? [ ^ ] $ ( ) { } = ! < > | :

Example #1 Esempio di preg_quote()

<?php
$keywords
= "$40 for a g3/400";
$keywords = preg_quote($keywords, "/");
echo
$keywords; // returns \$40 for a g3\/400
?>

Example #2 Esempio di come rendere in corsivo una qualsiasi parola di un testo

<?php
// In questo esempio, la funzione preg_quote($word) viene usata
// per impedire agli asterischi di avere il loro significato
// speciale per le espressioni regolari.

$testo = "Questo libro è *molto* difficile da trovare.";
$parola = "*molto*";
$testo = preg_replace("/". preg_quote($parola) . "/",
"<i>" . $parola . "</i>",
$testo);
?>

Nota: Questa funzione è binary-safe (gestisce correttamente i file binari)

add a note

User Contributed Notes 6 notes

up
74
Anonymous
17 years ago
Wondering why your preg_replace fails, even if you have used preg_quote?Try adding the delimiter / - preg_quote($string, '/');
up
16
zooly
16 years ago
To escape characters with special meaning, like: .-[]() and so on, use \Q and \E.For example:<?php echo ( preg_match('/^'.( $myvar = 'te.t' ).'$/i', 'test') ? 'match' : 'nomatch' ); ?>Will result in: matchBut:<?php echo ( preg_match('/^\Q'.( $myvar = 'te.t' ).'\E$/i', 'test') ? 'match' : 'nomatch' ); ?>Will result in: nomatch
up
6
ed at happysoftware dot com
6 years ago
It should be noted that the forward slash is not escaped.  Since many regexes are surrounded by forward slashes, if you have one in your regex as  text you must escape it yourself otherwise it'll terminat the regex.
up
4
rwillmann at crooce dot com
7 years ago
List of specials is incomplete:--- sample code ---$specials = '.\+*?[^]$(){}=!<>|:-';for ($i = 0; $i <= 255; $i++) {    if (chr($i) !== preg_quote(chr($i))) {        printf("Character 0x%02x quoted%s\n",               $i,               (strpos($specials, chr($i)) === FALSE) ? ' (+)' : '');    } /* if */} /* for */--- sample code ------ output ---Character 0x00 quoted (+)Character 0x21 quotedCharacter 0x24 quotedCharacter 0x28 quotedCharacter 0x29 quotedCharacter 0x2a quotedCharacter 0x2b quotedCharacter 0x2d quotedCharacter 0x2e quotedCharacter 0x3a quotedCharacter 0x3c quotedCharacter 0x3d quotedCharacter 0x3e quotedCharacter 0x3f quotedCharacter 0x5b quotedCharacter 0x5c quotedCharacter 0x5d quotedCharacter 0x5e quotedCharacter 0x7b quotedCharacter 0x7c quotedCharacter 0x7d quoted--- output ---
up
2
Anonymous
4 years ago
I discovered that, in addition to escaping the special regular expression characters, preg_quote() encodes the NUL byte to its octal representation:<?phpvar_dump(preg_quote("\0"));?>Output:string(4) "\000"
up
-3
rawr at t-regx dot com
4 years ago
To have a higher level control of what your pattern looks like, try T-Regx:Pattern::inject('This is (my|our) pattern: @', [$_GET['name']]);
To Top