cvs: phpdoc-it /reference/pcre configure.xml constants.xml reference.xml /reference/pcre/functions pcre.pattern.modifiers.xml pcre.pattern.syntax.xml
preg-grep.xml preg-match-all.xml preg-match.xml preg-quote.xml preg-replace-callback.xml preg-replace.xml preg-split.xml
| From: | Andrioli Darvin | Date: | Sun, 11 Jan 2004 20:16:12 +0000 |
| Subject: | cvs: phpdoc-it /reference/pcre configure.xml constants.xml reference.xml /reference/pcre/functions pcre.pattern.modifiers.xml pcre.pattern.syntax.xml preg-grep.xml preg-match-all.xml preg-match.xml preg-quote.xml preg-replace-callback.xml preg-replace.xml preg-split.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-500@lists.php.net to get a copy of this message | ||
darvina Sun Jan 11 15:16:12 2004 EDT
Modified files:
/phpdoc-it/reference/pcre configure.xml constants.xml reference.xml
/phpdoc-it/reference/pcre/functions pcre.pattern.modifiers.xml
pcre.pattern.syntax.xml
preg-grep.xml
preg-match-all.xml
preg-match.xml preg-quote.xml
preg-replace-callback.xml
preg-replace.xml preg-split.xml
Log:
Sync to En tree
Index: phpdoc-it/reference/pcre/configure.xml diff -u phpdoc-it/reference/pcre/configure.xml:1.1 phpdoc-it/reference/pcre/configure.xml:1.2 --- phpdoc-it/reference/pcre/configure.xml:1.1 Mon Feb 10 16:03:36 2003 +++ phpdoc-it/reference/pcre/configure.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <section id="pcre.installation"> &reftitle.install; <para> Index: phpdoc-it/reference/pcre/constants.xml diff -u phpdoc-it/reference/pcre/constants.xml:1.2 phpdoc-it/reference/pcre/constants.xml:1.3 --- phpdoc-it/reference/pcre/constants.xml:1.2 Thu Sep 12 01:52:16 2002 +++ phpdoc-it/reference/pcre/constants.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.1 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <section id="pcre.constants"> &reftitle.constants; &extension.constants; Index: phpdoc-it/reference/pcre/reference.xml diff -u phpdoc-it/reference/pcre/reference.xml:1.6 phpdoc-it/reference/pcre/reference.xml:1.7 --- phpdoc-it/reference/pcre/reference.xml:1.6 Mon Feb 10 16:04:01 2003 +++ phpdoc-it/reference/pcre/reference.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <reference id="ref.pcre"> <title>Funzioni per le espressioni regolari (Perl compatibili)</title> <titleabbrev>PCRE</titleabbrev> Index: phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml diff -u phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.4 phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.5 --- phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.4 Fri Jul 11 15:54:56 2003 +++ phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'pcre.pattern.modifiers' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="pcre.pattern.modifiers"> <refnamediv> @@ -100,7 +100,7 @@ le altre funzioni di PCRE lo ignorano. <note> <simpara> - Questo modificatore non è disponibile in PHP3. + Questo modificatore non è disponibile in PHP 3. </simpara> </note> </para> Index: phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml diff -u phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.4 phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.5 --- phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.4 Mon Feb 10 16:04:51 2003 +++ phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'pcre.pattern.syntax' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="pcre.pattern.syntax"> <refnamediv> @@ -783,14 +783,15 @@ <refsect2 id="regexp.reference.circudollar"> <title>I caratteri "^" e "$"</title> - <literallayout> + <para> In condizioni normali, il carattere "^", posto all'esterno di una classe di caratteri, indica un asserzione che è vera soltanto se il punto da cui si inizia a identificare il testo si trova all'inizio della stringa oggetto della ricerca. Al contrario, se il carattere "^" si trova all'interno di una classe di caratteri, assume altri significati (vedere i capitoli seguenti). - + </para> + <para> Non è necessario che il carattere "^" sia la prima lettera del criterio di riconoscimento nei casi in cui si utilizzino dei criteri di riconoscimento alternativi. Tuttavia è necessario @@ -800,7 +801,8 @@ dall'inizio della stringa, si dice che si è costruito un criterio di ricerca "ancorato". (Esistono anche altre costruzioni che portano all'ancoraggio di un criterio di ricerca). - + </para> + <para> Il carattere dollaro "$" è una asserzione che è &true; soltanto se il punto a cui si è arrivati ad identificare il testo si trova alla fine della stringa oggetto della ricerca, o @@ -811,13 +813,15 @@ alternativi. Deve, comunque, essere l'ultima lettera nei criteri ove compare. Il carattere dollaro "$" non ha significati speciali all'interno di una classe di caratteri. - + </para> + <para> Il comportamento del simbolo "$" può essere variato in modo da identificare la reale fine della stringa oggetto di ricerca attivando il flag <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> durante la compila o durante la fase di riconoscimento. Ciò non influisce sull'asserzione \Z. - + </para> + <para> Il comportamento dei simboli "^" e "$" può essere influenzato dall'opzione <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. Quando viene attivata, questi caratteri identificano rispettivamente, @@ -829,18 +833,19 @@ sono "ancorati" in modalità singola linea, non lo sono in modalità multi-linea. L'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> viene ignorata se si attiva il flag <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> . - + </para> + <para> Occorre rilevare che le sequenze \A, \Z e \z possono essere utilizzate per riconoscere l'inizio e la fine del testo in entrambe le modalità, e, se tutti i criteri alternativi iniziano con \A, si ha ancora un criterio "ancorato" a prescindere che sia attivata o meno l'opzione <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.dot"> <title>FULL STOP</title> - <literallayout> + <para> Il carattere punto ".", all'esterno di una classe di caratteri, identifica qualsiasi carattere, anche quelli non stampabili, ma (per default) non il carattere "a capo". Invece se si @@ -850,13 +855,12 @@ simboli "^" ed "$", l'unica relazione che possono avere riguarda il carattere "a capo". Il punto "." non ha significati speciali all'interno delle classi di caratteri. - - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.squarebrackets"> <title>Parentesi quadrate</title> - <literallayout> + <para> Un parentesi quadrata aperta "[" inizia una classe di caratteri; una parentesi quadrata chiusa "]" termina la definizione della classe. Di suo il carattere di parentesi quadrata chiusa @@ -864,7 +868,8 @@ chiusa all'interno di una classe di caratteri, questa deve essere la prima lettera (ovviamente deve seguire il carattere "^", se presente) oppure deve essere preceduta dal carattere di escape "\". - + </para> + <para> Una classe di caratteri identifica un singolo carattere nella stringa oggetto di ricerca; il carattere deve comparire nel set di caratteri definito dalla classe, a meno che il primo @@ -874,7 +879,8 @@ nel set definito dalla classe, questo non deve essere la prima lettera dopo la parentesi di apertura, oppure deve essere preceduto dal carattere di escape (\). - + </para> + <para> Ad esempio, la classe [aeiou] identifica ogni vocale minuscola, mentre [^aeiou] identifica tutti i caratteri che non siano delle vocali minuscole. Occorre notare che il simbolo "^" è un modo @@ -882,19 +888,22 @@ quelli che non lo sono. Questa non è una asserzione: consuma un carattere della stringa oggetto di ricerca e fallisce se ci si trova alla fine del testo. - + </para> + <para> In un riconoscimento senza distinzione tra minuscole e maiuscole, ogni lettera della classe identifica sia la versione maiuscola sia la minuscola. Così, ad esempio, la classe [aeiou] identifica sia "A" sia "a", e, in questo caso, [^aeiou] non identifica "A", mentre con la distinzione delle maiuscole [^aeiou] identifica la lettera "A". - + </para> + <para> Il carattere di "a capo" (newline) non viene trattato in modo speciale nelle classi di caratteri, indipendentemente dalle opzioni <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> o <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. La classe [^a] riconosce sempre il carattere "a capo". - + </para> + <para> Il segno meno (-) può essere usato per definire un intervallo all'interno della classe. Ad esempio, [d-m] identifica ogni lettera compresa tra d ed m inclusi. Se occorre inserire il @@ -903,7 +912,8 @@ una posizione tale che non possa essere identificato come definizione di un intervallo (ad esempio all'inizio o alla fine della definizione della classe). - + </para> + <para> Non è possibile usare il carattere "]" come limite di un intervallo. Un criterio definito come [W-]46], viene inteso come una classe di due caratteri (W e -) seguita dalla stringa @@ -913,7 +923,8 @@ correttamente come una singola classe contenente un range seguito da due caratteri separati. In alternativa, per delimitare l'intervallo si può utilizzare la notazione ottale di "]". - + </para> + <para> Gli intervalli utilizzano la sequenza di caratteri ASCII. Inoltre possono essere utilizzati per definire caratteri con specifica numerica (ad esempio [\000-\037]). Nei casi in cui @@ -925,7 +936,8 @@ si utilizza la tabella dei caratteri locali francesi "fr", [\xc8-\xcb] identifica la lettera "e" accentata sia maiuscola sia minuscola. - + </para> + <para> Nelle classi di caratteri si possono utilizzare le sequenze \d, \D, \s, \S, \w e \W per aggiungere altri tipi di caratteri alla classe. Ad esempio, [\dABCDEF] riconosce qualsiasi cifra @@ -934,20 +946,21 @@ che l'identificazione del set di caratteri minuscoli. Ad esempio, la classe [^\W_] identifica qualsiasi lettera o cifra ma non il trattino basso (_). - + </para> + <para> Tutti i caratteri non alfabetici, eccetto \, -, ^ (posto all'inizio) e ] non sono speciali per la classi di caratteri, e non sono dannosi se preceduti dal caratteri di escape (\). - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.verticalbar"> <title>Barra verticale (|)</title> - <literallayout> + <para> La barra verticale (|) viene utilizzata per separare criteri di riconoscimento alternativi. Ad esempio il seguente criterio - gilbert|sullivan + <literal>gilbert|sullivan</literal> può riconoscere "gilbert" oppure "sullivan". Ci possono essere innumerevoli alternative, compresa un'alternativa vuota (per @@ -956,24 +969,43 @@ fino a quando non ne trova una che sia soddisfatta. Se le alternative sono nella definizione di un criterio parziale il riconoscimento ha successo quando avviene su tutto il criterio. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.internal-options"> <title>Settaggio delle opzioni interne</title> - <literallayout> + <para> Le opzioni <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>, <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> , <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> possono essere cambiate "al volo" dall'interno del criterio di riconoscimento, utilizzando le sequenze di lettere definite per queste opzioni in Perl, racchiuse tra "(?" ed ")". Le lettere utilizzabili sono: - - i per <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> - m per <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> - s per <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> - x per <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> - + <table> + <title>Lettere per le opzioni interne</title> + <tgroup cols="2"> + <tbody> + <row> + <entry><literal>i</literal></entry> + <entry> per <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link></entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link></entry> + </row> + <row> + <entry><literal>x</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> Ad esempio, (?im) abilita il riconoscimento senza distinzione tra lettere maiuscole e minuscole e la modalità multi-linea. E' anche possibile disabilitare queste opzioni facendo precedere @@ -982,7 +1014,8 @@ <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> e si disattiva <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>. Se la lettera compare sia prima che dopo il segno meno (-) l'opzione resta disabilitata. - + </para> + <para> L'ambito di validità delle opzioni dipende da dove sono i flag di abilitazione/disabilitazione nel criterio di ricerca. Nei casi in cui il settaggio di un'opzione avvenga all'esterno @@ -990,26 +1023,29 @@ effetti sono medesimi di quando l'attivazione/disattivazione avviene all'inizio del criterio di riconoscimento. Gli esempi seguenti si comportano tutti allo stesso modo: - + </para> + <literallayout> (?i)abc a(?i)bc ab(?i)c abc(?i) - + </literallayout> + <para> In questi esempi si attiva <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> per il criterio "abc". In altre parole, questo settaggio compiuto al primo livello si applica a tutto il criterio (a meno che non vi siano altre variazioni nelle sotto-regole di riconoscimento). Qualora vi siano più settaggi per lo stesso parametro, viene utilizzato quello più a destra. - + </para> + <para> Se si inserisce la variazione di un'opzione in una sotto-regola gli effetti sono differenti. Questa è una variazione rispetto al comportamento di Perl 5.005. Una variazione apportata all'interno di una sotto-regola, vale solo per la parte della sotto-regola che segue la variazione, pertanto - (a(?i)b)c + <literal>(a(?i)b)c</literal> identifica abc, aBc e nessuna altra stringa ( si assume che <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> non sia usato). @@ -1018,14 +1054,15 @@ apportata ad una ramo alternativo del criterio viene estesa alle alternative successive della medesima sotto-regola. Ad esempio, - (a(?i)b|c) + <literal>(a(?i)b|c)</literal> identifica "ab", "aB", "c" e "C", anche se per identificare "C" viene scartato il primo ramo prima di incontrare il settaggio dell'opzione. Questo accade perché gli effetti dei settaggi vengono inseriti nella fase di compila. Diversamente si avrebbero dei comportamenti molto bizzarri. - + </para> + <para> Le opzioni specifiche di PCRE <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTRA</link> possono essere variate nel medesimo modo delle opzioni Perl compatibili, utilizzando rispettivamente i caratteri @@ -1033,26 +1070,28 @@ prima di qualsiasi opzione esso attivi anche quando si trova al primo livello. E' opportuno inserirlo all'inizio. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.subpatterns"> <title>Sotto-regole</title> - <literallayout> + <para> Le sotto-regole sono delimitate dalle parentesi tonde e possono essere annidate. La definizione di una parte di una regola di riconoscimento come sotto-regola può servire a: - + </para> + <para> 1. Localizzare un set di alternative. Ad esempio nel seguente criterio di riconoscimento - cat(aract|erpillar|) + <literal>cat(aract|erpillar|)</literal> si riconosce una tra le parole "cat", "cataract" oppure "caterpil- lar". Se non fossero state usate le parentesi, il criterio avrebbe permesso il riconoscimento delle parole "cataract", "erpillar" oppure una stringa vuota. - + </para> + <para> 2. Identificare e catturare parte del testo riconosciuto dalla sotto-regola (come illustrato in seguito). Quando il riconoscimento dell'intero criterio ha avuto successo, @@ -1062,15 +1101,17 @@ <function>pcre_exec</function>. Per determinare il numero ordinale di ciascuna sotto-regola si contano le parentesi aperte da sinistra verso destra partendo da 1. - + </para> + <para> Ad esempio, se si esegue un riconoscimento nella frase "the red king" con il seguente criterio - the ((red|white) (king|queen)) + <literal>the ((red|white) (king|queen))</literal> si ottengono i testi "red king", "red" e "king", rispettivamente identificati dalla sotto-regola 1, 2 e 3. - + </para> + <para> Il fatto che le parentesi tonde adempiano a due funzioni non sempre porta a situazioni comprensibili. Spesso capita di dovere raggruppare delle sotto-regole senza per questo essere @@ -1080,21 +1121,24 @@ conteggiata nel numero d'ordine delle sotto-regole di cattura. Ad esempio, applicando il criterio - the ((?:red|white) (king|queen)) + <literal>the ((?:red|white) (king|queen))</literal> alla frase "the white queen", si catturano i testi "white queen" e "queen", rispettivamente numerati 1 e 2. Il numero massimo di testi catturabili è 99, il numero massimo di sotto-regole, a prescindere che siano di cattura o meno, è 200. - + </para> + <para> Come utile abbreviazione, nei casi in cui l'attivazione di alcune opzioni debba essere fatta all'inizio di una sotto-regola non di cattura, la lettera dell'opzione può comparire tra la "?" e ":". Pertanto i due criteri - + </para> + <literallayout> (?i:saturday|sunday) (?:(?i)saturday|sunday) - + </literallayout> + <para> riconoscono esattamente lo stesso set di parole. Poiché i rami alternativi sono provati da sinistra verso destra, e le opzioni non sono azzerate fino a quando non si è conclusa la sotto-regola, @@ -1102,29 +1146,31 @@ le alternative che seguono. Pertanto, nell'esempio di prima, sia la parola "SUNDAY" che la parola "Saturday" sono testi identificati correttamente. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.repetition"> <title>Ripetizioni</title> - <literallayout> + <para> Le ripetizioni sono il numero delle occorrenze che possono essere indicate dopo i seguenti elementi: - - un singolo carattere, possibilmente preceduto dal carattere di escape (\) - il metacarattere . - una classe di caratteri - un riferimento all'indietro (vedere la sezione successiva) - una sotto-regola (a meno che non si tratti di una asserzione - - vedere più avanti) - + <itemizedlist> + <listitem><simpara>un singolo carattere, possibilmente preceduto dal carattere di escape (\)</simpara></listitem> + <listitem><simpara>il metacarattere .</simpara></listitem> + <listitem><simpara>una classe di caratteri</simpara></listitem> + <listitem><simpara>un riferimento all'indietro (vedere la sezione successiva)</simpara></listitem> + <listitem><simpara>una sotto-regola (a meno che non si tratti di una asserzione - + vedere più avanti)</simpara></listitem> + </itemizedlist> + </para> + <para> In generale una occorrenza specifica un numero minimo e massimo di riconoscimenti previsti tramite la specifica dei due limiti, posti tra parentesi graffe e separati da una virgola. Entrambi i numeri devono essere minori di 65536 ed il primo deve essere minore o uguale rispetto al secondo. Ad esempio: - z{2,4} + <literal>z{2,4}</literal> identifica "zz", "zzz" oppure "zzzz". La parentesi graffa chiusa di suo non rappresenta un carattere speciale. Se si omette il @@ -1133,11 +1179,11 @@ omessi, l'occorrenza specifica l'esatto numero di riconoscimenti richiesti. Il criterio - [aeiou]{3,} + <literal>[aeiou]{3,}</literal> identifica almeno 3 o più vocali consecutive, mentre - \d{8} + <literal>\d{8}</literal> identifica esattamente 8 cifre. Una parentesi graffa aperta che compaia in una posizione in cui non sia prevista una @@ -1145,29 +1191,49 @@ di una occorrenza, viene tratta come il carattere "{". Ad esempio {,6} non indica delle occorrenze, ma una stringa di 4 caratteri. - + </para> + <para> L'indicazione {0} è permessa. Indica di comportarsi come se l'elemento precedente all'occorrenza non fosse presente. - + </para> + <para> Per praticità (e compatibilità verso il passato) si usano 3 abbreviazioni per le occorrenze più comuni: - - * equivale a {0,} - + equivale a {1,} - ? equivale a {0,1} - + <table> + <title>Indicatore di occorrenza</title> + <tgroup cols="2"> + <tbody> + <row> + <entry><literal>*</literal></entry> + <entry>equivale a <literal>{0,}</literal></entry> + </row> + <row> + <entry><literal>+</literal></entry> + <entry>equivale a <literal>{1,}</literal></entry> + </row> + <row> + <entry><literal>?</literal></entry> + <entry>equivale a <literal>{0,1}</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> E' anche possibile creare un ciclo infinito facendo seguire ad una sotto-regola che non identifica alcun carattere una occorrenza priva di limite superiore. Ad esempio: - - (a?)* + <literal>(a?)*</literal> + </para> + <para> Le versioni precedenti di Perl e di PCRE segnalavano un errore durante la fase di compila per questi criteri. Tuttavia, poiché vi sono casi dove questi criteri possono essere utili, queste regole sono accettate, ma, se la ripetizione non riconosce alcun carattere, il ciclo viene interrotto. - + </para> + <para> Per default le occorrenze sono "bramose", infatti identificano più testi possibile (fino al numero massimo permesso), senza per questo fare fallire il riconoscimento della parte rimanente @@ -1178,20 +1244,21 @@ *, sia il carattere /. Il tentativo di individuare i commenti C con il seguente criterio - /\*.*\*/ + <literal>/\*.*\*/</literal> se applicato al commento - /* primo commento */ nessun commento /* secondo commento */ + <literal>/* primo commento */ nessun commento /* secondo commento */</literal> non ha successo, perché identifica l'intera stringa a causa della "bramosia" dell'elemento ".*". - + </para> + <para> Tuttavia, se un'occorrenza è seguita da un punto interrogativo, questa cessa di essere "bramosa", e identifica il numero minimo di testi permessi. Pertanto il criterio - /\*.*?\*/ + <literal>/\*.*?\*/</literal> si comporta correttamente con i commenti C. Il significato delle varie occorrenze non è stato cambiato, si è soltanto @@ -1200,24 +1267,27 @@ suo proprio significato. Dati i due utilizzi del ?, può anche capitare di averli entrambi come in - \d??\d + <literal>\d??\d</literal> che, preferibilmente, identifica una cifra, ma può riconoscerne due se questa è l'unica via per soddisfare il riconoscimento dell'intero criterio. - + </para> + <para> Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> (un'opzione disponibile anche in Perl), per default le occorrenze non sono "bramose", ma ogni singola occorrenza può essere resa "bramosa" se seguita dal punto interrogativo. In altre parole si è invertito il normale comportamento. - + </para> + <para> Quando si indica un numero minimo di occorrenze maggiore di 1, per una sotto-regola posta tra parentesi, oppure si indica un numero massimo di occorrenze, la fase di compila richiede più spazio in proporzione ai valori minimo e massimo. - + </para> + <para> Se un criterio inizia con .* oppure .{0,} e si è attivata l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> (equivalente al /s di Perl), permettendo al . di identificare @@ -1233,12 +1303,13 @@ se il criterio di ricerca inizia con ".*", per ottenere questa ottimizzazione, oppure, in alternativa, usare "^" per indicare in modo esplicito un ancoraggio. - + </para> + <para> Quando si ripete una sotto-regola di cattura, il testo estrapolato è la parte identificata dall'iterazione finale. Ad esempio se il criterio - (tweedle[dume]{3}\s*)+ + <literal>(tweedle[dume]{3}\s*)+</literal> viene applicato al testo "tweedledum tweedledee", il testo estrapolato sarà "tweedledee". Tuttavia se vi sono delle @@ -1246,21 +1317,22 @@ determinato dalle iterazioni precedenti. Ad esempio nel criterio - /(a|(b))+/ + <literal>/(a|(b))+/</literal> applicato a "aba", la seconda stringa catturata è "b". - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.back-references"> <title>Riferimenti all'indietro</title> - <literallayout> + <para> Esternamente ad una classe di caratteri, un backslah (\) seguito da una o più cifre maggiori di 0 è un riferimento all'indietro verso testi catturati precedentemente (ad esempio alla sinistra rispetto a dove ci si trova), conteggiati tramite il numero delle parentesi chiuse precedenti. - + </para> + <para> Tuttavia, se il numero che segue il backslash (\) è un valore inferiore a 10, si assume che si tratti sempre di un riferimento all'indietro, e pertanto viene generato un errore se nel criterio @@ -1270,13 +1342,14 @@ alla sotto-regola sia pari o maggiore al numero indicato. Vedere la sezione relativa al backslash per informazioni su come gestire le cifre seguenti il backslash. - + </para> + <para> Un riferimento all'indietro identifica ciò che è già stato catturato dalla sotto-regola, e non ciò che la sotto-regola stessa possa riconoscere. Ad esempio il criterio - (sens|respons)e and \1ibility + <literal>(sens|respons)e and \1ibility</literal> può riconoscere "sense and sensibility" oppure "response and responsibility", ma non il testo "sense and responsibility". @@ -1284,18 +1357,19 @@ tra lettere maiuscole e minuscole, il formato della lettera diventa rilevante. Ad esempio, - ((?i)rah)\s+\1 + <literal>((?i)rah)\s+\1</literal> può identificare "rah rah" e "RAH RAH", ma non "RAH rah", anche se la sotto-regola originale eseguiva dei riconoscimenti a prescindere dalle lettere maiuscole e minuscole. - + </para> + <para> Nella medesima sotto-regola si possono avere più di un riferimento all'indietro. Se una sotto-regola non viene utilizzata in un particolare riconoscimento, un riferimento a questa ha sempre esito negativo. Ad esempio il criterio - (a|(bc))\2 + <literal>(a|(bc))\2</literal> non avrà mai successo se l'identificazione della stringa inizia con "a" e non con "bc". Dato che sono possibili fino a 99 @@ -1306,14 +1380,15 @@ numero del riferimento. Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> questo carattere può essere lo spazio. Altrimenti si può usare un commento vuoto. - + </para> + <para> Un riferimento all'indietro non ha successo se viene inserito in una sotto regola prima che sia applicata. Con questo si intende, ad esempio, che (a\1) non avrà mai successo, ma, nel caso di una sottoregola ripetuta, si avrà un riscontro positivo. Ad esempio - (a|b\1)+ + <literal>(a|b\1)+</literal> identificherà qualsiasi numero di "a", ma anche "aba" oppure "ababaa" eccetera. In pratica a ciascuna iterazione della @@ -1324,12 +1399,12 @@ Ciò può essere ottenuto o usando casi alternativi, come nell'esempio precedente, o usando le occorrenze indicando come numero minimo di occorrenze il valore zero. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.assertions"> <title>Asserzioni</title> - <literallayout> + <para> L'asserzione è un test basato su un carattere, che può precedere o seguire l'attuale punto di riconoscimento, e non consuma alcun carattere. Le semplici asserzioni quali \b, \B, \A, \Z, @@ -1338,24 +1413,25 @@ Se ne hanno di due tipologie: quelle che "guardano avanti" alla posizione attuale nella stringa oggetto del riconoscimento, e quelle che "guardano dietro" la posizione attuale. - + </para> + <para> Una asserzione definita come sotto-regola esegue il riconoscimento nel modo usuale, ma tale riconoscimento non sposta la posizione attuale nella stringa. Le asserzioni che "guardano avanti" cominciano per "(?=", se sono positive, per "(?!", se sono asserzioni negative. Ad esempio - \w+(?=;) + <literal>\w+(?=;)</literal> riconosce una parola seguita da ";", ma non include il punto e virgola nel riconoscimento, mentre - foo(?!bar) + <literal>foo(?!bar)</literal> identifica qualsiasi occorrenza di "foo" che non sia seguita da "bar". Attenzione che il criterio, apparentemente simile, - (?!foo)bar + <literal>(?!foo)bar</literal> non riconosce alcuna occorrenza di "bar" se questa è preceduta da qualsiasi testo che non sia "foo"; infatti l'espressione @@ -1363,11 +1439,12 @@ è sempre &true; quando i tre caratteri successivi sono "bar". Pertanto è necessario una asserzione che "guarda" all'indietro per ottenere effetto desiderato. - + </para> + <para> Le asserzioni che "guardano" indietro positive iniziano con "(?<=", e con "(?<!" le negative. Ad esempio: - (?<!foo)bar + <literal>(?<!foo)bar</literal> riconosce una occorrenza di "bar" che non sia preceduta da "foo". Le asserzioni che "guardano" indietro hanno una limitazione: @@ -1375,11 +1452,11 @@ Mentre, se si hanno casi alternativi, la limitazione della lunghezza fissa non sussiste. Quindi - (?<=bullock|donkey) + <literal>(?<=bullock|donkey)</literal> è una asserzione permessa, ma - (?<!dogs?|cats?) + <literal>(?<!dogs?|cats?)</literal> genera un errore durante la fase di compila. Rami alternativi con lunghezze di stringa differenti sono permessi solo @@ -1388,13 +1465,13 @@ possibili la medesima lunghezza di stringa. Quindi una asserzione tipo - (?<=ab(c|de)) + <literal>(?<=ab(c|de))</literal> non è permessa, poiché il suo singolo ramo di primo livello può identificare testi di due lunghezze differenti, ma è accettabile se riscritta usando due alternative di primo livello: - (?<=abc|abde) + <literal>(?<=abc|abde)</literal> L'implementazione di questo tipo di asserzioni consiste, per ciascuna alternativa, di uno spostamento all'indietro temporaneo @@ -1406,11 +1483,12 @@ per identificare la fine dei testi; un esempio è illustrato al termine della sezione sulle sotto-regole a riconoscimento singolo. - + </para> + <para> Diverse asserzioni (di qualsiasi tipologia) possono essere utilizzate in modo consecutivo. Ad esempio: - (?<=\d{3})(?<!999)foo + <literal>(?<=\d{3})(?<!999)foo</literal> riconosce "foo" preceduto da tre cifre che non siano "999". Occorre rilevare che ciascuna asserzione viene applicata @@ -1422,27 +1500,29 @@ cifre e i secondi tre non siano "999". In pratica il testo "123abcfoo" non viene riconosciuto. Un criterio per riconoscere tale stringa può essere: - - (?<=\d{3}...)(?<!999)foo - + <literal>(?<=\d{3}...)(?<!999)foo</literal> + </para> + <para> In questo caso la prima asserzione controlla i primi sei caratteri verificando che i primi tre siano cifre, mentre la seconda asserzione verifica che i secondi tre caratteri non siano "999". - + </para> + <para> Le asserzioni possono essere annidate in qualsiasi combinazione. Il seguente esempio - (?<=(?<!foo)bar)baz + <literal>(?<=(?<!foo)bar)baz</literal> identifica il testo "baz" se è preceduto da "bar" il quale non deve essere preceduto da "foo", mentre - (?<=\d{3}(?!999)...)foo + <literal>(?<=\d{3}(?!999)...)foo</literal> è un'altro criterio che riconosce "foo" preceduto da tre cifre e da tre caratteri che non siano "999". - + </para> + <para> Le asserzioni definite come sotto-regole non catturano parte del testo e non possono essere ripetute (non avrebbe senso ripetere il medesimo riconoscimento sul medesimo testo). @@ -1451,16 +1531,17 @@ di cattura. Tuttavia il testo viene effettivamente catturato solo nelle asserzioni positive, dato che non avrebbe senso farlo in quelle negative. - + </para> + <para> Le asserzioni possono essere composte fino ad un massimo di 200 sotto-regole. subpatterns. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.onlyonce"> <title>Sotto-regole a riconoscimento singolo (Once-only subpatterns)</title> - <literallayout> + <para> Con l'indicazione del numero minimo e massimo di ripetizioni, il fallimento del riconoscimento della parte successiva del testo causa una ripetizione dell'identificazione con un numero di @@ -1470,12 +1551,13 @@ natura del criterio, oppure per fare fallire la ricerca prima di quando potrebbe accadere, oppure quando l'autore sa che non ci sono punti da cui ripartire. - + </para> + <para> Consideriamo, ad esempio, il criterio \d+foo applicato alla seguente linea - - 123456bar - + <literal>123456bar</literal> + </para> + <para> Dopo avere identificato le 6 cifre ed avere mancato nel riconoscimento di "foo", il comportamento normale consiste nel tentare di procedere identificando 5 cifre per l'elemento \d+, quindi @@ -1488,21 +1570,23 @@ L'espressione per definire questo tipo di sotto-regola richiede un'altro tipologia di utilizzo speciale delle parentesi. Infatti iniziano con (?> come nell'esempio seguente: - - (?>\d+)bar - + <literal>(?>\d+)bar</literal> + </para> + <para> Questa tipologia di parentesi "inchioda" la parte di criterio una volta che avviene il riconoscimento, e, quindi, un fallimento successivo impedisce la ri-elaborazione di questo segmento. Tuttavia, occorre notare che gli elementi precedenti a questo si comportano in modo normale, e pertanto la ri-elaborazione, pur non toccando questo elemento, passa ai precedenti. - + </para> + <para> Una descrizione alternativa di questa tipologia di sotto-regola potrebbe essere che questo criterio identifica un testo come avrebbe fatto un singolo criterio se fosse stato ancorato alla posizione corrente. - + </para> + <para> Le sotto-regole a riconoscimento singolo non compiono la cattura del testo identificato. I casi semplici illustrati in precedenza possono essere considerati come una estremizzazione della @@ -1511,16 +1595,18 @@ il numero corretto di cifre affinchè la ricerca abbia successo, dall'altra la sequenza (?>\d+) riconosce soltanto una sequenza di cifre. - + </para> + <para> Ovviamente queste costruzioni possono contenere diverse sotto-regole sia complesse, sia annidate. - + </para> + <para> Le sotto-regole a riconoscimento singolo possono essere usate congiuntamente alle asserzioni che guardano indietro, per definire una regola efficiente per riconoscere la fine della stringa. Ad esempio si consideri questo semplice criterio: - abcd$ + <literal>abcd$</literal> quando viene applicato ad un lungo testo può non avere successo. Questo perché il riconoscimento procede da sinistra verso destra, @@ -1528,7 +1614,7 @@ parte restante del criterio. Se si modifica il criterio nel seguente modo - ^.*abcd$ + <literal>^.*abcd$</literal> allora la sequenza iniziale .* in prima battuta identificherà tutto il testo, ma quando fallisce (poiché non vi sono più "a"), @@ -1539,7 +1625,7 @@ sinistra, senza ottenere nulla di valido. Tuttavia se si riscrive il criterio come: - ^(?>.*)(?<=abcd) + <literal>^(?>.*)(?<=abcd)</literal> non si attiva più lo scorrimento verso sinistra per .* , ma viene costretto a riconoscere tutto il testo (esito del primo tentativo). @@ -1547,7 +1633,8 @@ lettere.Se fallisce, ciò avviene immediatamente, provocando un impatto sensibile nei tempi di elaborazione con testi molto lunghi. - + </para> + <para> Quando un criterio di riconoscimento contiene un elemento ripetuto senza limite all'interno di una sotto-regola che anch'essa possa ripetuta illimitatamente, l'uso delle sotto-regole @@ -1555,14 +1642,14 @@ certi mancati riconoscimenti richiedano molto tempo per essere rilevati. Ad esempio il criterio - (\D+|<\d+>)*[!?] + <literal>(\D+|<\d+>)*[!?]</literal> riconosce un numero indefinito di frammenti di testo contenenti a loro volta numeri o caratteri non numerici racchiusi tra <>, seguiti dai caratteri ! o ?. Quando il riconoscimento ha successo l'esecuzione è rapida, ma quando viene applicato al testo - aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa + <literal>aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa</literal> richiede molto tempo prima di evidenziare l'errore. Questo accade perché la stringa può essere suddivisa tra i due elementi @@ -1575,32 +1662,35 @@ lo trovano nel testo, falliscono subito. Se il criterio viene modificato in - ((?>\D+)|<\d+>)*[!?] + <literal>((?>\D+)|<\d+>)*[!?]</literal> le sequenze di caratteri non numerici non possono essere interrotte e pertanto il mancato riconoscimento viene rilevato più velocemente. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.conditional"> <title>Sotto-regole condizionali (Conditional subpatterns)</title> - <literallayout> + <para> E' possibile forzare il processo di riconoscimento a obbedire alle sotto-regole in modo condizionato, oppure a scegliere tra due alternative in base al risultato di una asserzione, o piuttosto se la sotto-regola di cattura precedente ha riconosciuto il proprio testo. I due metodi possibili per esprimere una sotto-regola condizionale sono: - + </para> + <literallayout> (?(condizione)yes-pattern) (?(condizione)yes-pattern|no-pattern) - + </literallayout> + <para> Se la condizione è soddisfatta, si usa la regola indicata in yes-pattern, altrimenti si applica il no-pattern (qualora sia specificato). Se nella sotto-regola vi sono più di due alternative, PCRE segnala un errore in fase di compila. - + </para> + <para> Vi sono due tipi di condizioni. Se il testo tra le parentesi consiste in una sequenza di cifre, allora la condizione è soddisfatta se la sotto-regola di cattura di quel numero @@ -1609,8 +1699,9 @@ più leggibile (si assuma che sia attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>) e lo si divida in tre parti per praticità di discussione: - ( \( )? [^()]+ (?(1) \) ) - + <literal>( \( )? [^()]+ (?(1) \) )</literal> + </para> + <para> La prima parte riconosce una parentesi aperta opzionale, e, se è presente, indica quello come primo segmento di stringa catturato. La seconda parte riconosce uno o più caratteri che @@ -1623,17 +1714,20 @@ esegue nessun altro riconoscimento. In altre parole questo criterio identifica un testo che possa essere racchiuso tra parentesi opzionali. - + </para> + <para> Se la condizione non è una sequenza di cifre, deve essere una asserzione. Questa può essere sia una asserzione che guarda avanti, sia una asserzione cha guarda indietro, sia positiva sia negativa. Si consideri il seguente criterio, ancora una volta contenente spazi non significativi, e con due alternative nella seconda linea: - + </para> + <literallayout> (?(?=[^a-z]*[a-z]) \d{2}-[a-z]{3}-\d{2} | \d{2}-\d{2}-\d{2} ) - + </literallayout> + <para> La condizione è una asserzione che guarda avanti positiva, la quale identifica una sequenza opzionale di caratteri non alfabetici seguiti da una lettera. In altre parole, si testa la presenza @@ -1642,27 +1736,28 @@ altrimenti viene applicato il secondo criterio. Questo criterio riconosce stringhe in due formati dd-aaa-dd oppure dd-dd-dd, dove aaa sono lettere e dd sono numeri. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.comments"> <title>Commenti</title> - <literallayout> + <para> La sequenza (?# indica l'inizio di un commento che si conclude con la successiva parentesi chiusa. Parentesi annidate non sono permesse. I caratteri che fanno parte di un commento non giocano alcun ruolo nella fase di riconoscimento. - + </para> + <para> Se viene attivata l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>, un carattere # privo della sequenza di escape (\) all'esterno di una classe di caratteri apre un commento che continua fino al carattere di "a capo". - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.recursive"> <title>Criteri ricorsivi</title> - <literallayout> + <para> Si consideri il caso in cui si debba riconoscere una stringa tra parentesi, si supponga inoltre di dovere ammettere un numero arbitrario di parentesi annidate. Senza l'uso della ricorsione, il miglior @@ -1676,22 +1771,24 @@ (si assume che l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> sia attivata in modo da ignorare gli spazi): - \( ( (?>[^()]+) | (?R) )* \) - + <literal>\( ( (?>[^()]+) | (?R) )* \)</literal> + </para> + <para> In principio si identifica la parentesi di apertura. Quindi si cerca un numero indefinito di stringhe che possano essere composte da caratteri che non siano parentesi, oppure che siano riconosciute ricorsivamente dal criterio (ad esempio una stringa correttamente tra parentesi). Infine si cerca la parentesi di chiusura. - + </para> + <para> In questo particolare esempio si hanno arbitrarie ripetizioni annidate, e quindi l'uso delle sotto-regole a riconoscimento singolo per il riconoscimento della stringa priva di parentesi è particolarmente utile se il criterio viene applicato ad un testo non riconoscibile. Ad esempio, applicando il criterio a - (aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa() + <literal>(aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa()</literal> si ottiene un esito di mancato riconoscimento rapidamente. Se, al contrario, non si fosse usato il criterio a riconoscimento @@ -1700,20 +1797,21 @@ possono essere applicati al testo, richiedendo, pertanto, la verifica di tutte le combinazioni prima di fornire l'esito negativo. - + </para> + <para> Il valori restituiti da una sotto-regola di cattura sono quelli ottenuti dal livello di ricorsione più esterno. Se il criterio illustrato in precedenza venisse applicato al testo - (ab(cd)ef) + <literal>(ab(cd)ef)</literal> Il valore ottenuto sarebbe "ef", che rappresenta l'ultimo valore catturato al livello più alto. Se si aggiungono altre parentesi al criterio, ottenendo - \( ( ( (?>[^()]+) | (?R) )* ) \) - ^ ^ - ^ ^ allora il testo ottenuto sarebbe + <literal>\( ( ( (?>[^()]+) | (?R) )* ) \)</literal> + + allora il testo ottenuto sarebbe "ab(cd)ef", cioè il valore delle parentesi di livello più alto. Se nel criterio vi sono più di 15 sotto-regole di cattura, PCRE ha necessità di ottenere maggiore memoria per archiviare @@ -1723,12 +1821,12 @@ delle informazioni dei primi 15 testi catturati, dato che non vi è modo di restituire un messaggio di memoria insufficiente dalla ricorsione. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.performances"> <title>Performances</title> - <literallayout> + <para> Certi elementi utilizzati per i criteri di riconoscimento sono più efficienti di altri. E' più efficiente usare le classi di caratteri come [aeiou] piuttosto che un gruppo di alternative come (a|e|i|o|u). @@ -1736,7 +1834,8 @@ scopo è la più efficiente. Nel libro di Jeffrey Friedl sono illustrate varie tecniche sull'ottimizzazione delle espressioni regolari. - + </para> + <para> Quando un criterio comincia con .* ed è attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, il criterio è implicitamente ancorato da PCRE, dato che può rico- noscere solo l'inizio della stringa. Tuttavia, se non è attivo @@ -1747,13 +1846,14 @@ tire dal carattere immediatamente successivo ad uno di questi e non dall'inizio. Ad esempio il criterio - (.*) second + <literal>(.*) second</literal> può eseguire un riconoscimento nel testo "first\nand second" (dove \n indica il carattere "a capo") ottenendo "and" come prima stringa catturata. perché ciò accada è necessario che PCRE possa iniziare il riconoscimento dopo ogni "a capo". - + </para> + <para> Se si deve usare un simile criterio in stringhe che non conten- gono caratteri di "a capo", le performance migliori si possono ottenere abilitando <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, @@ -1761,14 +1861,15 @@ ancoraggio esplicito. Così si risparmia a PCRE di scandirsi il testo alla ricerca di un "a capo" da cui ripartire per la ri- cerca. - + </para> + <para> Occorre prestare attenzione ai criteri che contengono ripeti- zioni indefinite annidate. Possono richiedere molto tempo se applicati a stringhe non riconoscibili. Si consideri il fram- mento - - (a+)* - + <literal>(a+)*</literal> + </para> + <para> Questo può riconoscere "aaaa" in 33 modi differenti, e questo numero può crescere molto rapidamente se la stringa da ricono- scere è più lunga. (Il carattere di ripetizione * può eseguire @@ -1778,11 +1879,12 @@ parte successiva del criterio è tale da non permettere il com- pletamento del riconoscimento, PCRE, per principio, ugualmente tenta tutte le possibili variazioni, richiedendo diverso tempo. - + </para> + <para> Una ottimizzazione riesce a catturare qualche caso semplice come in - (a+)*b + <literal>(a+)*b</literal> dove si indica che seguirà un carattere alfanumerico. PCRE, prima di imbarcarsi nella procedura standard di riconoscimen- @@ -1792,13 +1894,13 @@ può essere utilizzata. Se ne può notare la differenza analiz- zando il comportamento del criterio - (a+)*\d + <literal>(a+)*\d</literal> rispetto al precedente. Il primo, utilizzato con una stringa composta da "a", fallisce immediatamente, l'ultimo richiede un tempo apprezzabile, soprattutto se applicato a stringhe con più di 20 caratteri. - </literallayout> + </para> </refsect2> </refsect1> </refentry> Index: phpdoc-it/reference/pcre/functions/preg-grep.xml diff -u phpdoc-it/reference/pcre/functions/preg-grep.xml:1.2 phpdoc-it/reference/pcre/functions/preg-grep.xml:1.3 --- phpdoc-it/reference/pcre/functions/preg-grep.xml:1.2 Wed Apr 17 03:07:57 2002 +++ phpdoc-it/reference/pcre/functions/preg-grep.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-grep' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-grep"> <refnamediv> @@ -16,6 +16,7 @@ <type>array </type><methodname>preg_grep</methodname> <methodparam><type>string </type><parameter>espressione_regolare</parameter></methodparam> <methodparam><type>array </type><parameter>testo</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> @@ -23,7 +24,23 @@ composta dagli elementi dell'array <parameter>testo</parameter> che soddisfano i criteri impostati nel parametro <parameter>espressione_regolare</parameter>. </para> - + <para> + Il parametro <parameter>flags</parameter> può assumere i seguenti valori: + <variablelist> + <varlistentry> + <term>PREG_GREP_INVERT</term> + <listitem> + <simpara> + Con questo valore, la funzione <function>preg_grep</function>gli elementi della matrice + di input che <emphasis>non</emphasis> soddisfano la data <parameter>espressione_regolare</parameter>. + Questo valore è disponibile a partire da <literal>PHP</literal> 4.2.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + Il parametro <parameter>flags</parameter> è stato inserito a partire da + <literal>PHP</literal> 4.3.0. + </para> <para> A partire dalla versione 4.0.4 di PHP, la matrice risultante dalla funzione <function>preg_grep</function>, viene indicizzata utilizzando le @@ -37,9 +54,11 @@ <title>Esempio di <function>preg_grep</function></title> <programlisting role="php"> <![CDATA[ +<?php // esempio di restituzione di tutti gli elementi della matrice // contenenti numeri in virgola mobile -$fl_array = preg_grep ("/^(\d+)?\.\d+$/", $array); +$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array); +?> ]]> </programlisting> </example> Index: phpdoc-it/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.8 phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.9 --- phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.8 Fri Jul 11 15:55:06 2003 +++ phpdoc-it/reference/pcre/functions/preg-match-all.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-match-all' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match-all"> <refnamediv> @@ -16,6 +16,7 @@ <methodparam><type>string </type><parameter>testo</parameter></methodparam> <methodparam><type>array </type><parameter>TestiRiconosciuti</parameter></methodparam> <methodparam choice="opt"><type>int </type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> La funzione ricerca tutte le espressioni regolari passate nel parametro <parameter>espressione_regolare</parameter> all'interno @@ -49,11 +50,11 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("|<[^>]+>(.*)</[^>]+>|U", +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>this is a test</div>", $out, PREG_PATTERN_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; +echo $out[0][0].", ".$out[0][1]."\n"; +echo $out[1][0].", ".$out[1][1]."\n"; ?> ]]> </programlisting> @@ -87,11 +88,11 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("|<[^>]+>(.*)</[^>]+>|U", - "<b>example: </b><div align=left>this is a test</div>", +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>example: </b><div align=\"left\">this is a test</div>", $out, PREG_SET_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; +echo $out[0][0].", ".$out[0][1]."\n"; +echo $out[1][0].", ".$out[1][1]."\n"; ?> ]]> </programlisting> @@ -101,7 +102,7 @@ <screen role="html"> <![CDATA[ <b>example: </b>, example: -<div align=left>this is a test</div>, this is a test +<div align="left">this is a test</div>, this is a test ]]> </screen> </informalexample> @@ -136,6 +137,14 @@ Qualora non si specifichi il parametro <parameter>flags</parameter>, si assume per default il valore PREG_PATTERN_ORDER. </para> + <para> + Normalemente la ricerca parte dall'inizio della stringa oggetto di ricerca. Con il parametro + opzionale <parameter>offset</parameter> si può specificare da dove cominciare + la ricerca. Equivale a passare <function>substr</function>($testo, $offset) alla funzione + <function>preg_match</function> al posto del parametro testo. + Il parametro <parameter>offset</parameter> è disponibile a partire dalla versione 4.3.3 di + <literal>PHP</literal>. + </para> <para> La funzione restituisce il numero dei riconoscimenti completi svolti (che possono essere zero), oppure &false; @@ -147,7 +156,7 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", +preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Call 555-1212 or 1-800-555-1212", $numeri); ?> ]]> @@ -166,13 +175,13 @@ // dei doppi apici. $html = "<b>bold text</b><a href=howdy.html>click me</a>"; -preg_match_all ("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); +preg_match_all("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); for ($i=0; $i< count($matches[0]); $i++) { echo "intero criterio: ".$matches[0][$i]."\n"; - echo "parte 1: ".$matches[1][$i]."\n"; - echo "parte 2: ".$matches[3][$i]."\n"; - echo "parte 3: ".$matches[4][$i]."\n\n"; + echo "parte 1: " . $matches[1][$i] . "\n"; + echo "parte 2: " . $matches[3][$i] . "\n"; + echo "parte 3: " . $matches[4][$i] . "\n\n"; } ?> ]]> Index: phpdoc-it/reference/pcre/functions/preg-match.xml diff -u phpdoc-it/reference/pcre/functions/preg-match.xml:1.5 phpdoc-it/reference/pcre/functions/preg-match.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-match.xml:1.5 Fri Jul 11 15:55:01 2003 +++ phpdoc-it/reference/pcre/functions/preg-match.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-match' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match"> <refnamediv> @@ -16,6 +16,7 @@ <methodparam><type>string </type><parameter>testo</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>testi_riconosciuti</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Esegue un riconoscimento nel parametro <parameter>testo</parameter> utilizzando @@ -47,7 +48,14 @@ Il parametro <parameter>flags</parameter> è disponibile a partire dalla versione 4.3.0 di <literal>PHP</literal>. </para> - + <para> + Normalemente la ricerca parte dall'inizio della stringa oggetto di ricerca. Con il parametro + opzionale <parameter>offset</parameter> si può specificare da dove cominciare + la ricerca. Equivale a passare <function>substr</function>($testo, $offset) alla funzione + <function>preg_match</function> al posto del parametro testo. + Il parametro <parameter>offset</parameter> è disponibile a partire dalla versione 4.3.3 di + <literal>PHP</literal>. + </para> <para> La funzione <function>preg_match</function> restituisce il numero di volte in cui è avvenuto il riconoscimento del <parameter>criterio</parameter>. Questo può essere 0 @@ -70,14 +78,12 @@ <title>Ricerca del testo "php"</title> <programlisting role="php"> <![CDATA[ - <?php - // La lettera "i" dopo i delimitatori indica una ricerca case-insensitive -if (preg_match ("/php/i", "PHP è il linguaggio scelto.")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/php/i", "PHP è il linguaggio scelto.")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } ?> ]]> @@ -92,15 +98,15 @@ <?php // La lettera \b nel criterio indica i limiti della parola. Così verrà riconosciuta solo // la parola "web" e non parte di una parola più lunga come "webbing" oppure "cobweb" -if (preg_match ("/\bweb\b/i", "PHP è un linguaggio di programmazione per il web scelto da molti.")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/\bweb\b/i", "PHP è un linguaggio di programmazione per il web scelto da molti.")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } -if (preg_match ("/\bweb\b/i", "PHP è un linguaggio di programmazione installato su molti website")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/\bweb\b/i", "PHP è un linguaggio di programmazione installato su molti website")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } ?> ]]> Index: phpdoc-it/reference/pcre/functions/preg-quote.xml diff -u phpdoc-it/reference/pcre/functions/preg-quote.xml:1.3 phpdoc-it/reference/pcre/functions/preg-quote.xml:1.4 --- phpdoc-it/reference/pcre/functions/preg-quote.xml:1.3 Fri Jul 11 15:54:51 2003 +++ phpdoc-it/reference/pcre/functions/preg-quote.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-quote' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-quote"> <refnamediv> @@ -39,9 +39,11 @@ <title>Esempio di <function>preg_quote</function></title> <programlisting role="php"> <![CDATA[ +<?php $keywords = "$40 for a g3/400"; -$keywords = preg_quote ($keywords, "/"); +$keywords = preg_quote($keywords, "/"); echo $keywords; // returns \$40 for a g3\/400 +?> ]]> </programlisting> </example> @@ -51,15 +53,17 @@ <title>Esempio di come rendere in corsivo una qualsiasi parola di un testo</title> <programlisting role="php"> <![CDATA[ +<?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 = preg_replace("/". preg_quote($parola) . "/", + "<i>" . $parola . "</i>", $testo); +?> ]]> </programlisting> </example> Index: phpdoc-it/reference/pcre/functions/preg-replace-callback.xml diff -u phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.6 phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.7 --- phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.6 Fri Jul 11 15:55:17 2003 +++ phpdoc-it/reference/pcre/functions/preg-replace-callback.xml Sun Jan 11 15:16:11 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> -<!-- last change to 'preg-replace-callback' in en/ tree in rev 1.47 --> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- OLD-Revision: 1.78/EN.1.47 --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <refentry id="function.preg-replace-callback"> <refnamediv> <refname>preg_replace_callback</refname> @@ -71,15 +68,15 @@ <programlisting role='php'> <![CDATA[ <?php - /* Un filtro da linea di comando stile Unix che converte - * la maiuscole poste all'inizio delle parole in minuscolo */ - - $fp = fopen("php://stdin", "r") or die("can't read stdin"); - while (!feof($fp)) { - $line = fgets($fp); - $line = preg_replace_callback( - '|<p>\s*\w|', - create_function( +/* Un filtro da linea di comando stile Unix che converte + * la maiuscole poste all'inizio delle parole in minuscolo */ + +$fp = fopen("php://stdin", "r") or die("can't read stdin"); +while (!feof($fp)) { + $line = fgets($fp); + $line = preg_replace_callback( + '|<p>\s*\w|', + create_function( // l'apice singolo è essenziale qui, // o in alternativa occorre usare la sequenza di escape \$ // per tutte le occorrenze di $ @@ -87,10 +84,10 @@ 'return strtolower($matches[0]);' ), $line - ); - echo $line; - } - fclose($fp); + ); + echo $line; +} +fclose($fp); ?> ]]> </programlisting> Index: phpdoc-it/reference/pcre/functions/preg-replace.xml diff -u phpdoc-it/reference/pcre/functions/preg-replace.xml:1.5 phpdoc-it/reference/pcre/functions/preg-replace.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-replace.xml:1.5 Fri Jul 11 15:55:12 2003 +++ phpdoc-it/reference/pcre/functions/preg-replace.xml Sun Jan 11 15:16:11 2004 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.5 --> -<!-- last change to 'preg-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> -<!-- OLD-Revision: 1.78/EN.1.2 --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <refentry id="function.preg-replace"> <refnamediv> <refname>preg_replace</refname> @@ -59,15 +57,18 @@ $string = "April 15, 2003"; $pattern = "/(\w+) (\d+), (\d+)/i"; $replacement = "\${1}1,\$3"; -print preg_replace($pattern, $replacement, $string); - -/* Output - ====== -April1,2003 -*/ +echo preg_replace($pattern, $replacement, $string); ?> ]]> </programlisting> + <para> + This example will output : + </para> + <screen> +<![CDATA[ +April1,2003 +]]> + </screen> </example> </para> <para> @@ -77,7 +78,7 @@ </para> <para> Ogni parametro passato alla funzione <function>preg_replace</function>, - (eccetto <parameter>limite</parameter>) può essere una matrice. + (eccetto <parameter>limite</parameter>) può essere una matrice ad una dimensione. Quando si utilizzano matrici con <parameter>espressione_regolare</parameter> e <parameter>sostituto</parameter>, le chiavi sono processate nell'ordine con cui appaiono nella matrice. Questo @@ -105,33 +106,40 @@ $replacements[1] = "black"; $replacements[0] = "slow"; -print preg_replace($patterns, $replacements, $string); - -/* Output - ====== - +echo preg_replace($patterns, $replacements, $string); +?> +]]> + </programlisting> + <para> + Output: + </para> + <screen> +<![CDATA[ The bear black slow jumped over the lazy dog. - -*/ - -/* utilizzando ksort su entrambe le matrici - otteniamo cio che vogliamo. */ - +]]> + </screen> + <para> + Utilizzando ksort su entrambe le matrici + otteniamo cio che vogliamo. + </para> + <programlisting role="php"> +<![CDATA[ +<?php ksort($patterns); ksort($replacements); -print preg_replace($patterns, $replacements, $string); - -/* Output - ====== - -The slow black bear jumped over the lazy dog. - -*/ - +echo preg_replace($patterns, $replacements, $string); ?> ]]> </programlisting> + <para> + Output : + </para> + <screen> +<![CDATA[ +The slow black bear jumped over the lazy dog. +]]> + </screen> </example> </para> <para> @@ -164,13 +172,13 @@ <para> <example> <title>Esempi di sostituzione di valori</title> - <programlisting> + <programlisting role="php"> <![CDATA[ <?php $patterns = array ("/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/", "/^\s*{(\w+)}\s*=/"); $replace = array ("\\3/\\4/\\1\\2", "$\\1 ="); -print preg_replace ($patterns, $replace, "{startDate} = 1999-5-27"); +echo preg_replace($patterns, $replace, "{startDate} = 1999-5-27"); ?> ]]> </programlisting> @@ -190,7 +198,7 @@ <programlisting role="php"> <![CDATA[ <?php -preg_replace ("/(<\/?)(\w+)([^>]*>)/e", +preg_replace("/(<\/?)(\w+)([^>]*>)/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); ?> @@ -241,7 +249,7 @@ chr(169), "chr(\\1)"); -$text = preg_replace ($search, $replace, $document); +$text = preg_replace($search, $replace, $document); ?> ]]> </programlisting> Index: phpdoc-it/reference/pcre/functions/preg-split.xml diff -u phpdoc-it/reference/pcre/functions/preg-split.xml:1.5 phpdoc-it/reference/pcre/functions/preg-split.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-split.xml:1.5 Fri Jul 11 15:55:23 2003 +++ phpdoc-it/reference/pcre/functions/preg-split.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-split' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-split"> <refnamediv> @@ -78,7 +78,7 @@ <?php // Suddivide la seguente frase in base alla presenza di virgole, spazi bianchi, // e altri caratteri speciali quali \r, \t, \n ed \f -$keywords = preg_split ("/[\s,]+/", "hypertext language, programming"); +$keywords = preg_split("/[\s,]+/", "hypertext language, programming"); ?> ]]> </programlisting>
Index: phpdoc-it/reference/pcre/configure.xml diff -u phpdoc-it/reference/pcre/configure.xml:1.1 phpdoc-it/reference/pcre/configure.xml:1.2 --- phpdoc-it/reference/pcre/configure.xml:1.1 Mon Feb 10 16:03:36 2003 +++ phpdoc-it/reference/pcre/configure.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <section id="pcre.installation"> &reftitle.install; <para> Index: phpdoc-it/reference/pcre/constants.xml diff -u phpdoc-it/reference/pcre/constants.xml:1.2 phpdoc-it/reference/pcre/constants.xml:1.3 --- phpdoc-it/reference/pcre/constants.xml:1.2 Thu Sep 12 01:52:16 2002 +++ phpdoc-it/reference/pcre/constants.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.1 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <section id="pcre.constants"> &reftitle.constants; &extension.constants; Index: phpdoc-it/reference/pcre/reference.xml diff -u phpdoc-it/reference/pcre/reference.xml:1.6 phpdoc-it/reference/pcre/reference.xml:1.7 --- phpdoc-it/reference/pcre/reference.xml:1.6 Mon Feb 10 16:04:01 2003 +++ phpdoc-it/reference/pcre/reference.xml Sun Jan 11 15:16:11 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <reference id="ref.pcre"> <title>Funzioni per le espressioni regolari (Perl compatibili)</title> <titleabbrev>PCRE</titleabbrev> Index: phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml diff -u phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.4 phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.5 --- phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml:1.4 Fri Jul 11 15:54:56 2003 +++ phpdoc-it/reference/pcre/functions/pcre.pattern.modifiers.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'pcre.pattern.modifiers' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="pcre.pattern.modifiers"> <refnamediv> @@ -100,7 +100,7 @@ le altre funzioni di PCRE lo ignorano. <note> <simpara> - Questo modificatore non è disponibile in PHP3. + Questo modificatore non è disponibile in PHP 3. </simpara> </note> </para> Index: phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml diff -u phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.4 phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.5 --- phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml:1.4 Mon Feb 10 16:04:51 2003 +++ phpdoc-it/reference/pcre/functions/pcre.pattern.syntax.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'pcre.pattern.syntax' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="pcre.pattern.syntax"> <refnamediv> @@ -783,14 +783,15 @@ <refsect2 id="regexp.reference.circudollar"> <title>I caratteri "^" e "$"</title> - <literallayout> + <para> In condizioni normali, il carattere "^", posto all'esterno di una classe di caratteri, indica un asserzione che è vera soltanto se il punto da cui si inizia a identificare il testo si trova all'inizio della stringa oggetto della ricerca. Al contrario, se il carattere "^" si trova all'interno di una classe di caratteri, assume altri significati (vedere i capitoli seguenti). - + </para> + <para> Non è necessario che il carattere "^" sia la prima lettera del criterio di riconoscimento nei casi in cui si utilizzino dei criteri di riconoscimento alternativi. Tuttavia è necessario @@ -800,7 +801,8 @@ dall'inizio della stringa, si dice che si è costruito un criterio di ricerca "ancorato". (Esistono anche altre costruzioni che portano all'ancoraggio di un criterio di ricerca). - + </para> + <para> Il carattere dollaro "$" è una asserzione che è &true; soltanto se il punto a cui si è arrivati ad identificare il testo si trova alla fine della stringa oggetto della ricerca, o @@ -811,13 +813,15 @@ alternativi. Deve, comunque, essere l'ultima lettera nei criteri ove compare. Il carattere dollaro "$" non ha significati speciali all'interno di una classe di caratteri. - + </para> + <para> Il comportamento del simbolo "$" può essere variato in modo da identificare la reale fine della stringa oggetto di ricerca attivando il flag <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> durante la compila o durante la fase di riconoscimento. Ciò non influisce sull'asserzione \Z. - + </para> + <para> Il comportamento dei simboli "^" e "$" può essere influenzato dall'opzione <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. Quando viene attivata, questi caratteri identificano rispettivamente, @@ -829,18 +833,19 @@ sono "ancorati" in modalità singola linea, non lo sono in modalità multi-linea. L'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> viene ignorata se si attiva il flag <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> . - + </para> + <para> Occorre rilevare che le sequenze \A, \Z e \z possono essere utilizzate per riconoscere l'inizio e la fine del testo in entrambe le modalità, e, se tutti i criteri alternativi iniziano con \A, si ha ancora un criterio "ancorato" a prescindere che sia attivata o meno l'opzione <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.dot"> <title>FULL STOP</title> - <literallayout> + <para> Il carattere punto ".", all'esterno di una classe di caratteri, identifica qualsiasi carattere, anche quelli non stampabili, ma (per default) non il carattere "a capo". Invece se si @@ -850,13 +855,12 @@ simboli "^" ed "$", l'unica relazione che possono avere riguarda il carattere "a capo". Il punto "." non ha significati speciali all'interno delle classi di caratteri. - - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.squarebrackets"> <title>Parentesi quadrate</title> - <literallayout> + <para> Un parentesi quadrata aperta "[" inizia una classe di caratteri; una parentesi quadrata chiusa "]" termina la definizione della classe. Di suo il carattere di parentesi quadrata chiusa @@ -864,7 +868,8 @@ chiusa all'interno di una classe di caratteri, questa deve essere la prima lettera (ovviamente deve seguire il carattere "^", se presente) oppure deve essere preceduta dal carattere di escape "\". - + </para> + <para> Una classe di caratteri identifica un singolo carattere nella stringa oggetto di ricerca; il carattere deve comparire nel set di caratteri definito dalla classe, a meno che il primo @@ -874,7 +879,8 @@ nel set definito dalla classe, questo non deve essere la prima lettera dopo la parentesi di apertura, oppure deve essere preceduto dal carattere di escape (\). - + </para> + <para> Ad esempio, la classe [aeiou] identifica ogni vocale minuscola, mentre [^aeiou] identifica tutti i caratteri che non siano delle vocali minuscole. Occorre notare che il simbolo "^" è un modo @@ -882,19 +888,22 @@ quelli che non lo sono. Questa non è una asserzione: consuma un carattere della stringa oggetto di ricerca e fallisce se ci si trova alla fine del testo. - + </para> + <para> In un riconoscimento senza distinzione tra minuscole e maiuscole, ogni lettera della classe identifica sia la versione maiuscola sia la minuscola. Così, ad esempio, la classe [aeiou] identifica sia "A" sia "a", e, in questo caso, [^aeiou] non identifica "A", mentre con la distinzione delle maiuscole [^aeiou] identifica la lettera "A". - + </para> + <para> Il carattere di "a capo" (newline) non viene trattato in modo speciale nelle classi di caratteri, indipendentemente dalle opzioni <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> o <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>. La classe [^a] riconosce sempre il carattere "a capo". - + </para> + <para> Il segno meno (-) può essere usato per definire un intervallo all'interno della classe. Ad esempio, [d-m] identifica ogni lettera compresa tra d ed m inclusi. Se occorre inserire il @@ -903,7 +912,8 @@ una posizione tale che non possa essere identificato come definizione di un intervallo (ad esempio all'inizio o alla fine della definizione della classe). - + </para> + <para> Non è possibile usare il carattere "]" come limite di un intervallo. Un criterio definito come [W-]46], viene inteso come una classe di due caratteri (W e -) seguita dalla stringa @@ -913,7 +923,8 @@ correttamente come una singola classe contenente un range seguito da due caratteri separati. In alternativa, per delimitare l'intervallo si può utilizzare la notazione ottale di "]". - + </para> + <para> Gli intervalli utilizzano la sequenza di caratteri ASCII. Inoltre possono essere utilizzati per definire caratteri con specifica numerica (ad esempio [\000-\037]). Nei casi in cui @@ -925,7 +936,8 @@ si utilizza la tabella dei caratteri locali francesi "fr", [\xc8-\xcb] identifica la lettera "e" accentata sia maiuscola sia minuscola. - + </para> + <para> Nelle classi di caratteri si possono utilizzare le sequenze \d, \D, \s, \S, \w e \W per aggiungere altri tipi di caratteri alla classe. Ad esempio, [\dABCDEF] riconosce qualsiasi cifra @@ -934,20 +946,21 @@ che l'identificazione del set di caratteri minuscoli. Ad esempio, la classe [^\W_] identifica qualsiasi lettera o cifra ma non il trattino basso (_). - + </para> + <para> Tutti i caratteri non alfabetici, eccetto \, -, ^ (posto all'inizio) e ] non sono speciali per la classi di caratteri, e non sono dannosi se preceduti dal caratteri di escape (\). - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.verticalbar"> <title>Barra verticale (|)</title> - <literallayout> + <para> La barra verticale (|) viene utilizzata per separare criteri di riconoscimento alternativi. Ad esempio il seguente criterio - gilbert|sullivan + <literal>gilbert|sullivan</literal> può riconoscere "gilbert" oppure "sullivan". Ci possono essere innumerevoli alternative, compresa un'alternativa vuota (per @@ -956,24 +969,43 @@ fino a quando non ne trova una che sia soddisfatta. Se le alternative sono nella definizione di un criterio parziale il riconoscimento ha successo quando avviene su tutto il criterio. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.internal-options"> <title>Settaggio delle opzioni interne</title> - <literallayout> + <para> Le opzioni <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>, <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> , <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> possono essere cambiate "al volo" dall'interno del criterio di riconoscimento, utilizzando le sequenze di lettere definite per queste opzioni in Perl, racchiuse tra "(?" ed ")". Le lettere utilizzabili sono: - - i per <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> - m per <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> - s per <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> - x per <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> - + <table> + <title>Lettere per le opzioni interne</title> + <tgroup cols="2"> + <tbody> + <row> + <entry><literal>i</literal></entry> + <entry> per <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link></entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link></entry> + </row> + <row> + <entry><literal>x</literal></entry> + <entry>per <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> Ad esempio, (?im) abilita il riconoscimento senza distinzione tra lettere maiuscole e minuscole e la modalità multi-linea. E' anche possibile disabilitare queste opzioni facendo precedere @@ -982,7 +1014,8 @@ <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> e si disattiva <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>. Se la lettera compare sia prima che dopo il segno meno (-) l'opzione resta disabilitata. - + </para> + <para> L'ambito di validità delle opzioni dipende da dove sono i flag di abilitazione/disabilitazione nel criterio di ricerca. Nei casi in cui il settaggio di un'opzione avvenga all'esterno @@ -990,26 +1023,29 @@ effetti sono medesimi di quando l'attivazione/disattivazione avviene all'inizio del criterio di riconoscimento. Gli esempi seguenti si comportano tutti allo stesso modo: - + </para> + <literallayout> (?i)abc a(?i)bc ab(?i)c abc(?i) - + </literallayout> + <para> In questi esempi si attiva <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> per il criterio "abc". In altre parole, questo settaggio compiuto al primo livello si applica a tutto il criterio (a meno che non vi siano altre variazioni nelle sotto-regole di riconoscimento). Qualora vi siano più settaggi per lo stesso parametro, viene utilizzato quello più a destra. - + </para> + <para> Se si inserisce la variazione di un'opzione in una sotto-regola gli effetti sono differenti. Questa è una variazione rispetto al comportamento di Perl 5.005. Una variazione apportata all'interno di una sotto-regola, vale solo per la parte della sotto-regola che segue la variazione, pertanto - (a(?i)b)c + <literal>(a(?i)b)c</literal> identifica abc, aBc e nessuna altra stringa ( si assume che <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> non sia usato). @@ -1018,14 +1054,15 @@ apportata ad una ramo alternativo del criterio viene estesa alle alternative successive della medesima sotto-regola. Ad esempio, - (a(?i)b|c) + <literal>(a(?i)b|c)</literal> identifica "ab", "aB", "c" e "C", anche se per identificare "C" viene scartato il primo ramo prima di incontrare il settaggio dell'opzione. Questo accade perché gli effetti dei settaggi vengono inseriti nella fase di compila. Diversamente si avrebbero dei comportamenti molto bizzarri. - + </para> + <para> Le opzioni specifiche di PCRE <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> e <link linkend="pcre.pattern.modifiers">PCRE_EXTRA</link> possono essere variate nel medesimo modo delle opzioni Perl compatibili, utilizzando rispettivamente i caratteri @@ -1033,26 +1070,28 @@ prima di qualsiasi opzione esso attivi anche quando si trova al primo livello. E' opportuno inserirlo all'inizio. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.subpatterns"> <title>Sotto-regole</title> - <literallayout> + <para> Le sotto-regole sono delimitate dalle parentesi tonde e possono essere annidate. La definizione di una parte di una regola di riconoscimento come sotto-regola può servire a: - + </para> + <para> 1. Localizzare un set di alternative. Ad esempio nel seguente criterio di riconoscimento - cat(aract|erpillar|) + <literal>cat(aract|erpillar|)</literal> si riconosce una tra le parole "cat", "cataract" oppure "caterpil- lar". Se non fossero state usate le parentesi, il criterio avrebbe permesso il riconoscimento delle parole "cataract", "erpillar" oppure una stringa vuota. - + </para> + <para> 2. Identificare e catturare parte del testo riconosciuto dalla sotto-regola (come illustrato in seguito). Quando il riconoscimento dell'intero criterio ha avuto successo, @@ -1062,15 +1101,17 @@ <function>pcre_exec</function>. Per determinare il numero ordinale di ciascuna sotto-regola si contano le parentesi aperte da sinistra verso destra partendo da 1. - + </para> + <para> Ad esempio, se si esegue un riconoscimento nella frase "the red king" con il seguente criterio - the ((red|white) (king|queen)) + <literal>the ((red|white) (king|queen))</literal> si ottengono i testi "red king", "red" e "king", rispettivamente identificati dalla sotto-regola 1, 2 e 3. - + </para> + <para> Il fatto che le parentesi tonde adempiano a due funzioni non sempre porta a situazioni comprensibili. Spesso capita di dovere raggruppare delle sotto-regole senza per questo essere @@ -1080,21 +1121,24 @@ conteggiata nel numero d'ordine delle sotto-regole di cattura. Ad esempio, applicando il criterio - the ((?:red|white) (king|queen)) + <literal>the ((?:red|white) (king|queen))</literal> alla frase "the white queen", si catturano i testi "white queen" e "queen", rispettivamente numerati 1 e 2. Il numero massimo di testi catturabili è 99, il numero massimo di sotto-regole, a prescindere che siano di cattura o meno, è 200. - + </para> + <para> Come utile abbreviazione, nei casi in cui l'attivazione di alcune opzioni debba essere fatta all'inizio di una sotto-regola non di cattura, la lettera dell'opzione può comparire tra la "?" e ":". Pertanto i due criteri - + </para> + <literallayout> (?i:saturday|sunday) (?:(?i)saturday|sunday) - + </literallayout> + <para> riconoscono esattamente lo stesso set di parole. Poiché i rami alternativi sono provati da sinistra verso destra, e le opzioni non sono azzerate fino a quando non si è conclusa la sotto-regola, @@ -1102,29 +1146,31 @@ le alternative che seguono. Pertanto, nell'esempio di prima, sia la parola "SUNDAY" che la parola "Saturday" sono testi identificati correttamente. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.repetition"> <title>Ripetizioni</title> - <literallayout> + <para> Le ripetizioni sono il numero delle occorrenze che possono essere indicate dopo i seguenti elementi: - - un singolo carattere, possibilmente preceduto dal carattere di escape (\) - il metacarattere . - una classe di caratteri - un riferimento all'indietro (vedere la sezione successiva) - una sotto-regola (a meno che non si tratti di una asserzione - - vedere più avanti) - + <itemizedlist> + <listitem><simpara>un singolo carattere, possibilmente preceduto dal carattere di escape (\)</simpara></listitem> + <listitem><simpara>il metacarattere .</simpara></listitem> + <listitem><simpara>una classe di caratteri</simpara></listitem> + <listitem><simpara>un riferimento all'indietro (vedere la sezione successiva)</simpara></listitem> + <listitem><simpara>una sotto-regola (a meno che non si tratti di una asserzione - + vedere più avanti)</simpara></listitem> + </itemizedlist> + </para> + <para> In generale una occorrenza specifica un numero minimo e massimo di riconoscimenti previsti tramite la specifica dei due limiti, posti tra parentesi graffe e separati da una virgola. Entrambi i numeri devono essere minori di 65536 ed il primo deve essere minore o uguale rispetto al secondo. Ad esempio: - z{2,4} + <literal>z{2,4}</literal> identifica "zz", "zzz" oppure "zzzz". La parentesi graffa chiusa di suo non rappresenta un carattere speciale. Se si omette il @@ -1133,11 +1179,11 @@ omessi, l'occorrenza specifica l'esatto numero di riconoscimenti richiesti. Il criterio - [aeiou]{3,} + <literal>[aeiou]{3,}</literal> identifica almeno 3 o più vocali consecutive, mentre - \d{8} + <literal>\d{8}</literal> identifica esattamente 8 cifre. Una parentesi graffa aperta che compaia in una posizione in cui non sia prevista una @@ -1145,29 +1191,49 @@ di una occorrenza, viene tratta come il carattere "{". Ad esempio {,6} non indica delle occorrenze, ma una stringa di 4 caratteri. - + </para> + <para> L'indicazione {0} è permessa. Indica di comportarsi come se l'elemento precedente all'occorrenza non fosse presente. - + </para> + <para> Per praticità (e compatibilità verso il passato) si usano 3 abbreviazioni per le occorrenze più comuni: - - * equivale a {0,} - + equivale a {1,} - ? equivale a {0,1} - + <table> + <title>Indicatore di occorrenza</title> + <tgroup cols="2"> + <tbody> + <row> + <entry><literal>*</literal></entry> + <entry>equivale a <literal>{0,}</literal></entry> + </row> + <row> + <entry><literal>+</literal></entry> + <entry>equivale a <literal>{1,}</literal></entry> + </row> + <row> + <entry><literal>?</literal></entry> + <entry>equivale a <literal>{0,1}</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> E' anche possibile creare un ciclo infinito facendo seguire ad una sotto-regola che non identifica alcun carattere una occorrenza priva di limite superiore. Ad esempio: - - (a?)* + <literal>(a?)*</literal> + </para> + <para> Le versioni precedenti di Perl e di PCRE segnalavano un errore durante la fase di compila per questi criteri. Tuttavia, poiché vi sono casi dove questi criteri possono essere utili, queste regole sono accettate, ma, se la ripetizione non riconosce alcun carattere, il ciclo viene interrotto. - + </para> + <para> Per default le occorrenze sono "bramose", infatti identificano più testi possibile (fino al numero massimo permesso), senza per questo fare fallire il riconoscimento della parte rimanente @@ -1178,20 +1244,21 @@ *, sia il carattere /. Il tentativo di individuare i commenti C con il seguente criterio - /\*.*\*/ + <literal>/\*.*\*/</literal> se applicato al commento - /* primo commento */ nessun commento /* secondo commento */ + <literal>/* primo commento */ nessun commento /* secondo commento */</literal> non ha successo, perché identifica l'intera stringa a causa della "bramosia" dell'elemento ".*". - + </para> + <para> Tuttavia, se un'occorrenza è seguita da un punto interrogativo, questa cessa di essere "bramosa", e identifica il numero minimo di testi permessi. Pertanto il criterio - /\*.*?\*/ + <literal>/\*.*?\*/</literal> si comporta correttamente con i commenti C. Il significato delle varie occorrenze non è stato cambiato, si è soltanto @@ -1200,24 +1267,27 @@ suo proprio significato. Dati i due utilizzi del ?, può anche capitare di averli entrambi come in - \d??\d + <literal>\d??\d</literal> che, preferibilmente, identifica una cifra, ma può riconoscerne due se questa è l'unica via per soddisfare il riconoscimento dell'intero criterio. - + </para> + <para> Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> (un'opzione disponibile anche in Perl), per default le occorrenze non sono "bramose", ma ogni singola occorrenza può essere resa "bramosa" se seguita dal punto interrogativo. In altre parole si è invertito il normale comportamento. - + </para> + <para> Quando si indica un numero minimo di occorrenze maggiore di 1, per una sotto-regola posta tra parentesi, oppure si indica un numero massimo di occorrenze, la fase di compila richiede più spazio in proporzione ai valori minimo e massimo. - + </para> + <para> Se un criterio inizia con .* oppure .{0,} e si è attivata l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> (equivalente al /s di Perl), permettendo al . di identificare @@ -1233,12 +1303,13 @@ se il criterio di ricerca inizia con ".*", per ottenere questa ottimizzazione, oppure, in alternativa, usare "^" per indicare in modo esplicito un ancoraggio. - + </para> + <para> Quando si ripete una sotto-regola di cattura, il testo estrapolato è la parte identificata dall'iterazione finale. Ad esempio se il criterio - (tweedle[dume]{3}\s*)+ + <literal>(tweedle[dume]{3}\s*)+</literal> viene applicato al testo "tweedledum tweedledee", il testo estrapolato sarà "tweedledee". Tuttavia se vi sono delle @@ -1246,21 +1317,22 @@ determinato dalle iterazioni precedenti. Ad esempio nel criterio - /(a|(b))+/ + <literal>/(a|(b))+/</literal> applicato a "aba", la seconda stringa catturata è "b". - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.back-references"> <title>Riferimenti all'indietro</title> - <literallayout> + <para> Esternamente ad una classe di caratteri, un backslah (\) seguito da una o più cifre maggiori di 0 è un riferimento all'indietro verso testi catturati precedentemente (ad esempio alla sinistra rispetto a dove ci si trova), conteggiati tramite il numero delle parentesi chiuse precedenti. - + </para> + <para> Tuttavia, se il numero che segue il backslash (\) è un valore inferiore a 10, si assume che si tratti sempre di un riferimento all'indietro, e pertanto viene generato un errore se nel criterio @@ -1270,13 +1342,14 @@ alla sotto-regola sia pari o maggiore al numero indicato. Vedere la sezione relativa al backslash per informazioni su come gestire le cifre seguenti il backslash. - + </para> + <para> Un riferimento all'indietro identifica ciò che è già stato catturato dalla sotto-regola, e non ciò che la sotto-regola stessa possa riconoscere. Ad esempio il criterio - (sens|respons)e and \1ibility + <literal>(sens|respons)e and \1ibility</literal> può riconoscere "sense and sensibility" oppure "response and responsibility", ma non il testo "sense and responsibility". @@ -1284,18 +1357,19 @@ tra lettere maiuscole e minuscole, il formato della lettera diventa rilevante. Ad esempio, - ((?i)rah)\s+\1 + <literal>((?i)rah)\s+\1</literal> può identificare "rah rah" e "RAH RAH", ma non "RAH rah", anche se la sotto-regola originale eseguiva dei riconoscimenti a prescindere dalle lettere maiuscole e minuscole. - + </para> + <para> Nella medesima sotto-regola si possono avere più di un riferimento all'indietro. Se una sotto-regola non viene utilizzata in un particolare riconoscimento, un riferimento a questa ha sempre esito negativo. Ad esempio il criterio - (a|(bc))\2 + <literal>(a|(bc))\2</literal> non avrà mai successo se l'identificazione della stringa inizia con "a" e non con "bc". Dato che sono possibili fino a 99 @@ -1306,14 +1380,15 @@ numero del riferimento. Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> questo carattere può essere lo spazio. Altrimenti si può usare un commento vuoto. - + </para> + <para> Un riferimento all'indietro non ha successo se viene inserito in una sotto regola prima che sia applicata. Con questo si intende, ad esempio, che (a\1) non avrà mai successo, ma, nel caso di una sottoregola ripetuta, si avrà un riscontro positivo. Ad esempio - (a|b\1)+ + <literal>(a|b\1)+</literal> identificherà qualsiasi numero di "a", ma anche "aba" oppure "ababaa" eccetera. In pratica a ciascuna iterazione della @@ -1324,12 +1399,12 @@ Ciò può essere ottenuto o usando casi alternativi, come nell'esempio precedente, o usando le occorrenze indicando come numero minimo di occorrenze il valore zero. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.assertions"> <title>Asserzioni</title> - <literallayout> + <para> L'asserzione è un test basato su un carattere, che può precedere o seguire l'attuale punto di riconoscimento, e non consuma alcun carattere. Le semplici asserzioni quali \b, \B, \A, \Z, @@ -1338,24 +1413,25 @@ Se ne hanno di due tipologie: quelle che "guardano avanti" alla posizione attuale nella stringa oggetto del riconoscimento, e quelle che "guardano dietro" la posizione attuale. - + </para> + <para> Una asserzione definita come sotto-regola esegue il riconoscimento nel modo usuale, ma tale riconoscimento non sposta la posizione attuale nella stringa. Le asserzioni che "guardano avanti" cominciano per "(?=", se sono positive, per "(?!", se sono asserzioni negative. Ad esempio - \w+(?=;) + <literal>\w+(?=;)</literal> riconosce una parola seguita da ";", ma non include il punto e virgola nel riconoscimento, mentre - foo(?!bar) + <literal>foo(?!bar)</literal> identifica qualsiasi occorrenza di "foo" che non sia seguita da "bar". Attenzione che il criterio, apparentemente simile, - (?!foo)bar + <literal>(?!foo)bar</literal> non riconosce alcuna occorrenza di "bar" se questa è preceduta da qualsiasi testo che non sia "foo"; infatti l'espressione @@ -1363,11 +1439,12 @@ è sempre &true; quando i tre caratteri successivi sono "bar". Pertanto è necessario una asserzione che "guarda" all'indietro per ottenere effetto desiderato. - + </para> + <para> Le asserzioni che "guardano" indietro positive iniziano con "(?<=", e con "(?<!" le negative. Ad esempio: - (?<!foo)bar + <literal>(?<!foo)bar</literal> riconosce una occorrenza di "bar" che non sia preceduta da "foo". Le asserzioni che "guardano" indietro hanno una limitazione: @@ -1375,11 +1452,11 @@ Mentre, se si hanno casi alternativi, la limitazione della lunghezza fissa non sussiste. Quindi - (?<=bullock|donkey) + <literal>(?<=bullock|donkey)</literal> è una asserzione permessa, ma - (?<!dogs?|cats?) + <literal>(?<!dogs?|cats?)</literal> genera un errore durante la fase di compila. Rami alternativi con lunghezze di stringa differenti sono permessi solo @@ -1388,13 +1465,13 @@ possibili la medesima lunghezza di stringa. Quindi una asserzione tipo - (?<=ab(c|de)) + <literal>(?<=ab(c|de))</literal> non è permessa, poiché il suo singolo ramo di primo livello può identificare testi di due lunghezze differenti, ma è accettabile se riscritta usando due alternative di primo livello: - (?<=abc|abde) + <literal>(?<=abc|abde)</literal> L'implementazione di questo tipo di asserzioni consiste, per ciascuna alternativa, di uno spostamento all'indietro temporaneo @@ -1406,11 +1483,12 @@ per identificare la fine dei testi; un esempio è illustrato al termine della sezione sulle sotto-regole a riconoscimento singolo. - + </para> + <para> Diverse asserzioni (di qualsiasi tipologia) possono essere utilizzate in modo consecutivo. Ad esempio: - (?<=\d{3})(?<!999)foo + <literal>(?<=\d{3})(?<!999)foo</literal> riconosce "foo" preceduto da tre cifre che non siano "999". Occorre rilevare che ciascuna asserzione viene applicata @@ -1422,27 +1500,29 @@ cifre e i secondi tre non siano "999". In pratica il testo "123abcfoo" non viene riconosciuto. Un criterio per riconoscere tale stringa può essere: - - (?<=\d{3}...)(?<!999)foo - + <literal>(?<=\d{3}...)(?<!999)foo</literal> + </para> + <para> In questo caso la prima asserzione controlla i primi sei caratteri verificando che i primi tre siano cifre, mentre la seconda asserzione verifica che i secondi tre caratteri non siano "999". - + </para> + <para> Le asserzioni possono essere annidate in qualsiasi combinazione. Il seguente esempio - (?<=(?<!foo)bar)baz + <literal>(?<=(?<!foo)bar)baz</literal> identifica il testo "baz" se è preceduto da "bar" il quale non deve essere preceduto da "foo", mentre - (?<=\d{3}(?!999)...)foo + <literal>(?<=\d{3}(?!999)...)foo</literal> è un'altro criterio che riconosce "foo" preceduto da tre cifre e da tre caratteri che non siano "999". - + </para> + <para> Le asserzioni definite come sotto-regole non catturano parte del testo e non possono essere ripetute (non avrebbe senso ripetere il medesimo riconoscimento sul medesimo testo). @@ -1451,16 +1531,17 @@ di cattura. Tuttavia il testo viene effettivamente catturato solo nelle asserzioni positive, dato che non avrebbe senso farlo in quelle negative. - + </para> + <para> Le asserzioni possono essere composte fino ad un massimo di 200 sotto-regole. subpatterns. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.onlyonce"> <title>Sotto-regole a riconoscimento singolo (Once-only subpatterns)</title> - <literallayout> + <para> Con l'indicazione del numero minimo e massimo di ripetizioni, il fallimento del riconoscimento della parte successiva del testo causa una ripetizione dell'identificazione con un numero di @@ -1470,12 +1551,13 @@ natura del criterio, oppure per fare fallire la ricerca prima di quando potrebbe accadere, oppure quando l'autore sa che non ci sono punti da cui ripartire. - + </para> + <para> Consideriamo, ad esempio, il criterio \d+foo applicato alla seguente linea - - 123456bar - + <literal>123456bar</literal> + </para> + <para> Dopo avere identificato le 6 cifre ed avere mancato nel riconoscimento di "foo", il comportamento normale consiste nel tentare di procedere identificando 5 cifre per l'elemento \d+, quindi @@ -1488,21 +1570,23 @@ L'espressione per definire questo tipo di sotto-regola richiede un'altro tipologia di utilizzo speciale delle parentesi. Infatti iniziano con (?> come nell'esempio seguente: - - (?>\d+)bar - + <literal>(?>\d+)bar</literal> + </para> + <para> Questa tipologia di parentesi "inchioda" la parte di criterio una volta che avviene il riconoscimento, e, quindi, un fallimento successivo impedisce la ri-elaborazione di questo segmento. Tuttavia, occorre notare che gli elementi precedenti a questo si comportano in modo normale, e pertanto la ri-elaborazione, pur non toccando questo elemento, passa ai precedenti. - + </para> + <para> Una descrizione alternativa di questa tipologia di sotto-regola potrebbe essere che questo criterio identifica un testo come avrebbe fatto un singolo criterio se fosse stato ancorato alla posizione corrente. - + </para> + <para> Le sotto-regole a riconoscimento singolo non compiono la cattura del testo identificato. I casi semplici illustrati in precedenza possono essere considerati come una estremizzazione della @@ -1511,16 +1595,18 @@ il numero corretto di cifre affinchè la ricerca abbia successo, dall'altra la sequenza (?>\d+) riconosce soltanto una sequenza di cifre. - + </para> + <para> Ovviamente queste costruzioni possono contenere diverse sotto-regole sia complesse, sia annidate. - + </para> + <para> Le sotto-regole a riconoscimento singolo possono essere usate congiuntamente alle asserzioni che guardano indietro, per definire una regola efficiente per riconoscere la fine della stringa. Ad esempio si consideri questo semplice criterio: - abcd$ + <literal>abcd$</literal> quando viene applicato ad un lungo testo può non avere successo. Questo perché il riconoscimento procede da sinistra verso destra, @@ -1528,7 +1614,7 @@ parte restante del criterio. Se si modifica il criterio nel seguente modo - ^.*abcd$ + <literal>^.*abcd$</literal> allora la sequenza iniziale .* in prima battuta identificherà tutto il testo, ma quando fallisce (poiché non vi sono più "a"), @@ -1539,7 +1625,7 @@ sinistra, senza ottenere nulla di valido. Tuttavia se si riscrive il criterio come: - ^(?>.*)(?<=abcd) + <literal>^(?>.*)(?<=abcd)</literal> non si attiva più lo scorrimento verso sinistra per .* , ma viene costretto a riconoscere tutto il testo (esito del primo tentativo). @@ -1547,7 +1633,8 @@ lettere.Se fallisce, ciò avviene immediatamente, provocando un impatto sensibile nei tempi di elaborazione con testi molto lunghi. - + </para> + <para> Quando un criterio di riconoscimento contiene un elemento ripetuto senza limite all'interno di una sotto-regola che anch'essa possa ripetuta illimitatamente, l'uso delle sotto-regole @@ -1555,14 +1642,14 @@ certi mancati riconoscimenti richiedano molto tempo per essere rilevati. Ad esempio il criterio - (\D+|<\d+>)*[!?] + <literal>(\D+|<\d+>)*[!?]</literal> riconosce un numero indefinito di frammenti di testo contenenti a loro volta numeri o caratteri non numerici racchiusi tra <>, seguiti dai caratteri ! o ?. Quando il riconoscimento ha successo l'esecuzione è rapida, ma quando viene applicato al testo - aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa + <literal>aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa</literal> richiede molto tempo prima di evidenziare l'errore. Questo accade perché la stringa può essere suddivisa tra i due elementi @@ -1575,32 +1662,35 @@ lo trovano nel testo, falliscono subito. Se il criterio viene modificato in - ((?>\D+)|<\d+>)*[!?] + <literal>((?>\D+)|<\d+>)*[!?]</literal> le sequenze di caratteri non numerici non possono essere interrotte e pertanto il mancato riconoscimento viene rilevato più velocemente. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.conditional"> <title>Sotto-regole condizionali (Conditional subpatterns)</title> - <literallayout> + <para> E' possibile forzare il processo di riconoscimento a obbedire alle sotto-regole in modo condizionato, oppure a scegliere tra due alternative in base al risultato di una asserzione, o piuttosto se la sotto-regola di cattura precedente ha riconosciuto il proprio testo. I due metodi possibili per esprimere una sotto-regola condizionale sono: - + </para> + <literallayout> (?(condizione)yes-pattern) (?(condizione)yes-pattern|no-pattern) - + </literallayout> + <para> Se la condizione è soddisfatta, si usa la regola indicata in yes-pattern, altrimenti si applica il no-pattern (qualora sia specificato). Se nella sotto-regola vi sono più di due alternative, PCRE segnala un errore in fase di compila. - + </para> + <para> Vi sono due tipi di condizioni. Se il testo tra le parentesi consiste in una sequenza di cifre, allora la condizione è soddisfatta se la sotto-regola di cattura di quel numero @@ -1609,8 +1699,9 @@ più leggibile (si assuma che sia attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>) e lo si divida in tre parti per praticità di discussione: - ( \( )? [^()]+ (?(1) \) ) - + <literal>( \( )? [^()]+ (?(1) \) )</literal> + </para> + <para> La prima parte riconosce una parentesi aperta opzionale, e, se è presente, indica quello come primo segmento di stringa catturato. La seconda parte riconosce uno o più caratteri che @@ -1623,17 +1714,20 @@ esegue nessun altro riconoscimento. In altre parole questo criterio identifica un testo che possa essere racchiuso tra parentesi opzionali. - + </para> + <para> Se la condizione non è una sequenza di cifre, deve essere una asserzione. Questa può essere sia una asserzione che guarda avanti, sia una asserzione cha guarda indietro, sia positiva sia negativa. Si consideri il seguente criterio, ancora una volta contenente spazi non significativi, e con due alternative nella seconda linea: - + </para> + <literallayout> (?(?=[^a-z]*[a-z]) \d{2}-[a-z]{3}-\d{2} | \d{2}-\d{2}-\d{2} ) - + </literallayout> + <para> La condizione è una asserzione che guarda avanti positiva, la quale identifica una sequenza opzionale di caratteri non alfabetici seguiti da una lettera. In altre parole, si testa la presenza @@ -1642,27 +1736,28 @@ altrimenti viene applicato il secondo criterio. Questo criterio riconosce stringhe in due formati dd-aaa-dd oppure dd-dd-dd, dove aaa sono lettere e dd sono numeri. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.comments"> <title>Commenti</title> - <literallayout> + <para> La sequenza (?# indica l'inizio di un commento che si conclude con la successiva parentesi chiusa. Parentesi annidate non sono permesse. I caratteri che fanno parte di un commento non giocano alcun ruolo nella fase di riconoscimento. - + </para> + <para> Se viene attivata l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>, un carattere # privo della sequenza di escape (\) all'esterno di una classe di caratteri apre un commento che continua fino al carattere di "a capo". - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.recursive"> <title>Criteri ricorsivi</title> - <literallayout> + <para> Si consideri il caso in cui si debba riconoscere una stringa tra parentesi, si supponga inoltre di dovere ammettere un numero arbitrario di parentesi annidate. Senza l'uso della ricorsione, il miglior @@ -1676,22 +1771,24 @@ (si assume che l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> sia attivata in modo da ignorare gli spazi): - \( ( (?>[^()]+) | (?R) )* \) - + <literal>\( ( (?>[^()]+) | (?R) )* \)</literal> + </para> + <para> In principio si identifica la parentesi di apertura. Quindi si cerca un numero indefinito di stringhe che possano essere composte da caratteri che non siano parentesi, oppure che siano riconosciute ricorsivamente dal criterio (ad esempio una stringa correttamente tra parentesi). Infine si cerca la parentesi di chiusura. - + </para> + <para> In questo particolare esempio si hanno arbitrarie ripetizioni annidate, e quindi l'uso delle sotto-regole a riconoscimento singolo per il riconoscimento della stringa priva di parentesi è particolarmente utile se il criterio viene applicato ad un testo non riconoscibile. Ad esempio, applicando il criterio a - (aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa() + <literal>(aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa()</literal> si ottiene un esito di mancato riconoscimento rapidamente. Se, al contrario, non si fosse usato il criterio a riconoscimento @@ -1700,20 +1797,21 @@ possono essere applicati al testo, richiedendo, pertanto, la verifica di tutte le combinazioni prima di fornire l'esito negativo. - + </para> + <para> Il valori restituiti da una sotto-regola di cattura sono quelli ottenuti dal livello di ricorsione più esterno. Se il criterio illustrato in precedenza venisse applicato al testo - (ab(cd)ef) + <literal>(ab(cd)ef)</literal> Il valore ottenuto sarebbe "ef", che rappresenta l'ultimo valore catturato al livello più alto. Se si aggiungono altre parentesi al criterio, ottenendo - \( ( ( (?>[^()]+) | (?R) )* ) \) - ^ ^ - ^ ^ allora il testo ottenuto sarebbe + <literal>\( ( ( (?>[^()]+) | (?R) )* ) \)</literal> + + allora il testo ottenuto sarebbe "ab(cd)ef", cioè il valore delle parentesi di livello più alto. Se nel criterio vi sono più di 15 sotto-regole di cattura, PCRE ha necessità di ottenere maggiore memoria per archiviare @@ -1723,12 +1821,12 @@ delle informazioni dei primi 15 testi catturati, dato che non vi è modo di restituire un messaggio di memoria insufficiente dalla ricorsione. - </literallayout> + </para> </refsect2> <refsect2 id="regexp.reference.performances"> <title>Performances</title> - <literallayout> + <para> Certi elementi utilizzati per i criteri di riconoscimento sono più efficienti di altri. E' più efficiente usare le classi di caratteri come [aeiou] piuttosto che un gruppo di alternative come (a|e|i|o|u). @@ -1736,7 +1834,8 @@ scopo è la più efficiente. Nel libro di Jeffrey Friedl sono illustrate varie tecniche sull'ottimizzazione delle espressioni regolari. - + </para> + <para> Quando un criterio comincia con .* ed è attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, il criterio è implicitamente ancorato da PCRE, dato che può rico- noscere solo l'inizio della stringa. Tuttavia, se non è attivo @@ -1747,13 +1846,14 @@ tire dal carattere immediatamente successivo ad uno di questi e non dall'inizio. Ad esempio il criterio - (.*) second + <literal>(.*) second</literal> può eseguire un riconoscimento nel testo "first\nand second" (dove \n indica il carattere "a capo") ottenendo "and" come prima stringa catturata. perché ciò accada è necessario che PCRE possa iniziare il riconoscimento dopo ogni "a capo". - + </para> + <para> Se si deve usare un simile criterio in stringhe che non conten- gono caratteri di "a capo", le performance migliori si possono ottenere abilitando <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, @@ -1761,14 +1861,15 @@ ancoraggio esplicito. Così si risparmia a PCRE di scandirsi il testo alla ricerca di un "a capo" da cui ripartire per la ri- cerca. - + </para> + <para> Occorre prestare attenzione ai criteri che contengono ripeti- zioni indefinite annidate. Possono richiedere molto tempo se applicati a stringhe non riconoscibili. Si consideri il fram- mento - - (a+)* - + <literal>(a+)*</literal> + </para> + <para> Questo può riconoscere "aaaa" in 33 modi differenti, e questo numero può crescere molto rapidamente se la stringa da ricono- scere è più lunga. (Il carattere di ripetizione * può eseguire @@ -1778,11 +1879,12 @@ parte successiva del criterio è tale da non permettere il com- pletamento del riconoscimento, PCRE, per principio, ugualmente tenta tutte le possibili variazioni, richiedendo diverso tempo. - + </para> + <para> Una ottimizzazione riesce a catturare qualche caso semplice come in - (a+)*b + <literal>(a+)*b</literal> dove si indica che seguirà un carattere alfanumerico. PCRE, prima di imbarcarsi nella procedura standard di riconoscimen- @@ -1792,13 +1894,13 @@ può essere utilizzata. Se ne può notare la differenza analiz- zando il comportamento del criterio - (a+)*\d + <literal>(a+)*\d</literal> rispetto al precedente. Il primo, utilizzato con una stringa composta da "a", fallisce immediatamente, l'ultimo richiede un tempo apprezzabile, soprattutto se applicato a stringhe con più di 20 caratteri. - </literallayout> + </para> </refsect2> </refsect1> </refentry> Index: phpdoc-it/reference/pcre/functions/preg-grep.xml diff -u phpdoc-it/reference/pcre/functions/preg-grep.xml:1.2 phpdoc-it/reference/pcre/functions/preg-grep.xml:1.3 --- phpdoc-it/reference/pcre/functions/preg-grep.xml:1.2 Wed Apr 17 03:07:57 2002 +++ phpdoc-it/reference/pcre/functions/preg-grep.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-grep' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-grep"> <refnamediv> @@ -16,6 +16,7 @@ <type>array </type><methodname>preg_grep</methodname> <methodparam><type>string </type><parameter>espressione_regolare</parameter></methodparam> <methodparam><type>array </type><parameter>testo</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> @@ -23,7 +24,23 @@ composta dagli elementi dell'array <parameter>testo</parameter> che soddisfano i criteri impostati nel parametro <parameter>espressione_regolare</parameter>. </para> - + <para> + Il parametro <parameter>flags</parameter> può assumere i seguenti valori: + <variablelist> + <varlistentry> + <term>PREG_GREP_INVERT</term> + <listitem> + <simpara> + Con questo valore, la funzione <function>preg_grep</function>gli elementi della matrice + di input che <emphasis>non</emphasis> soddisfano la data <parameter>espressione_regolare</parameter>. + Questo valore è disponibile a partire da <literal>PHP</literal> 4.2.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + Il parametro <parameter>flags</parameter> è stato inserito a partire da + <literal>PHP</literal> 4.3.0. + </para> <para> A partire dalla versione 4.0.4 di PHP, la matrice risultante dalla funzione <function>preg_grep</function>, viene indicizzata utilizzando le @@ -37,9 +54,11 @@ <title>Esempio di <function>preg_grep</function></title> <programlisting role="php"> <![CDATA[ +<?php // esempio di restituzione di tutti gli elementi della matrice // contenenti numeri in virgola mobile -$fl_array = preg_grep ("/^(\d+)?\.\d+$/", $array); +$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array); +?> ]]> </programlisting> </example> Index: phpdoc-it/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.8 phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.9 --- phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.8 Fri Jul 11 15:55:06 2003 +++ phpdoc-it/reference/pcre/functions/preg-match-all.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-match-all' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match-all"> <refnamediv> @@ -16,6 +16,7 @@ <methodparam><type>string </type><parameter>testo</parameter></methodparam> <methodparam><type>array </type><parameter>TestiRiconosciuti</parameter></methodparam> <methodparam choice="opt"><type>int </type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> La funzione ricerca tutte le espressioni regolari passate nel parametro <parameter>espressione_regolare</parameter> all'interno @@ -49,11 +50,11 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("|<[^>]+>(.*)</[^>]+>|U", +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>this is a test</div>", $out, PREG_PATTERN_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; +echo $out[0][0].", ".$out[0][1]."\n"; +echo $out[1][0].", ".$out[1][1]."\n"; ?> ]]> </programlisting> @@ -87,11 +88,11 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("|<[^>]+>(.*)</[^>]+>|U", - "<b>example: </b><div align=left>this is a test</div>", +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>example: </b><div align=\"left\">this is a test</div>", $out, PREG_SET_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; +echo $out[0][0].", ".$out[0][1]."\n"; +echo $out[1][0].", ".$out[1][1]."\n"; ?> ]]> </programlisting> @@ -101,7 +102,7 @@ <screen role="html"> <![CDATA[ <b>example: </b>, example: -<div align=left>this is a test</div>, this is a test +<div align="left">this is a test</div>, this is a test ]]> </screen> </informalexample> @@ -136,6 +137,14 @@ Qualora non si specifichi il parametro <parameter>flags</parameter>, si assume per default il valore PREG_PATTERN_ORDER. </para> + <para> + Normalemente la ricerca parte dall'inizio della stringa oggetto di ricerca. Con il parametro + opzionale <parameter>offset</parameter> si può specificare da dove cominciare + la ricerca. Equivale a passare <function>substr</function>($testo, $offset) alla funzione + <function>preg_match</function> al posto del parametro testo. + Il parametro <parameter>offset</parameter> è disponibile a partire dalla versione 4.3.3 di + <literal>PHP</literal>. + </para> <para> La funzione restituisce il numero dei riconoscimenti completi svolti (che possono essere zero), oppure &false; @@ -147,7 +156,7 @@ <programlisting role="php"> <![CDATA[ <?php -preg_match_all ("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", +preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Call 555-1212 or 1-800-555-1212", $numeri); ?> ]]> @@ -166,13 +175,13 @@ // dei doppi apici. $html = "<b>bold text</b><a href=howdy.html>click me</a>"; -preg_match_all ("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); +preg_match_all("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); for ($i=0; $i< count($matches[0]); $i++) { echo "intero criterio: ".$matches[0][$i]."\n"; - echo "parte 1: ".$matches[1][$i]."\n"; - echo "parte 2: ".$matches[3][$i]."\n"; - echo "parte 3: ".$matches[4][$i]."\n\n"; + echo "parte 1: " . $matches[1][$i] . "\n"; + echo "parte 2: " . $matches[3][$i] . "\n"; + echo "parte 3: " . $matches[4][$i] . "\n\n"; } ?> ]]> Index: phpdoc-it/reference/pcre/functions/preg-match.xml diff -u phpdoc-it/reference/pcre/functions/preg-match.xml:1.5 phpdoc-it/reference/pcre/functions/preg-match.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-match.xml:1.5 Fri Jul 11 15:55:01 2003 +++ phpdoc-it/reference/pcre/functions/preg-match.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-match' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match"> <refnamediv> @@ -16,6 +16,7 @@ <methodparam><type>string </type><parameter>testo</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>testi_riconosciuti</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> Esegue un riconoscimento nel parametro <parameter>testo</parameter> utilizzando @@ -47,7 +48,14 @@ Il parametro <parameter>flags</parameter> è disponibile a partire dalla versione 4.3.0 di <literal>PHP</literal>. </para> - + <para> + Normalemente la ricerca parte dall'inizio della stringa oggetto di ricerca. Con il parametro + opzionale <parameter>offset</parameter> si può specificare da dove cominciare + la ricerca. Equivale a passare <function>substr</function>($testo, $offset) alla funzione + <function>preg_match</function> al posto del parametro testo. + Il parametro <parameter>offset</parameter> è disponibile a partire dalla versione 4.3.3 di + <literal>PHP</literal>. + </para> <para> La funzione <function>preg_match</function> restituisce il numero di volte in cui è avvenuto il riconoscimento del <parameter>criterio</parameter>. Questo può essere 0 @@ -70,14 +78,12 @@ <title>Ricerca del testo "php"</title> <programlisting role="php"> <![CDATA[ - <?php - // La lettera "i" dopo i delimitatori indica una ricerca case-insensitive -if (preg_match ("/php/i", "PHP è il linguaggio scelto.")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/php/i", "PHP è il linguaggio scelto.")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } ?> ]]> @@ -92,15 +98,15 @@ <?php // La lettera \b nel criterio indica i limiti della parola. Così verrà riconosciuta solo // la parola "web" e non parte di una parola più lunga come "webbing" oppure "cobweb" -if (preg_match ("/\bweb\b/i", "PHP è un linguaggio di programmazione per il web scelto da molti.")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/\bweb\b/i", "PHP è un linguaggio di programmazione per il web scelto da molti.")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } -if (preg_match ("/\bweb\b/i", "PHP è un linguaggio di programmazione installato su molti website")) { - print "Il riconoscimento è avvenuto."; +if (preg_match("/\bweb\b/i", "PHP è un linguaggio di programmazione installato su molti website")) { + echo "Il riconoscimento è avvenuto."; } else { - print "Testo non riconosciuto."; + echo "Testo non riconosciuto."; } ?> ]]> Index: phpdoc-it/reference/pcre/functions/preg-quote.xml diff -u phpdoc-it/reference/pcre/functions/preg-quote.xml:1.3 phpdoc-it/reference/pcre/functions/preg-quote.xml:1.4 --- phpdoc-it/reference/pcre/functions/preg-quote.xml:1.3 Fri Jul 11 15:54:51 2003 +++ phpdoc-it/reference/pcre/functions/preg-quote.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-quote' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-quote"> <refnamediv> @@ -39,9 +39,11 @@ <title>Esempio di <function>preg_quote</function></title> <programlisting role="php"> <![CDATA[ +<?php $keywords = "$40 for a g3/400"; -$keywords = preg_quote ($keywords, "/"); +$keywords = preg_quote($keywords, "/"); echo $keywords; // returns \$40 for a g3\/400 +?> ]]> </programlisting> </example> @@ -51,15 +53,17 @@ <title>Esempio di come rendere in corsivo una qualsiasi parola di un testo</title> <programlisting role="php"> <![CDATA[ +<?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 = preg_replace("/". preg_quote($parola) . "/", + "<i>" . $parola . "</i>", $testo); +?> ]]> </programlisting> </example> Index: phpdoc-it/reference/pcre/functions/preg-replace-callback.xml diff -u phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.6 phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.7 --- phpdoc-it/reference/pcre/functions/preg-replace-callback.xml:1.6 Fri Jul 11 15:55:17 2003 +++ phpdoc-it/reference/pcre/functions/preg-replace-callback.xml Sun Jan 11 15:16:11 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> -<!-- last change to 'preg-replace-callback' in en/ tree in rev 1.47 --> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- OLD-Revision: 1.78/EN.1.47 --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <refentry id="function.preg-replace-callback"> <refnamediv> <refname>preg_replace_callback</refname> @@ -71,15 +68,15 @@ <programlisting role='php'> <![CDATA[ <?php - /* Un filtro da linea di comando stile Unix che converte - * la maiuscole poste all'inizio delle parole in minuscolo */ - - $fp = fopen("php://stdin", "r") or die("can't read stdin"); - while (!feof($fp)) { - $line = fgets($fp); - $line = preg_replace_callback( - '|<p>\s*\w|', - create_function( +/* Un filtro da linea di comando stile Unix che converte + * la maiuscole poste all'inizio delle parole in minuscolo */ + +$fp = fopen("php://stdin", "r") or die("can't read stdin"); +while (!feof($fp)) { + $line = fgets($fp); + $line = preg_replace_callback( + '|<p>\s*\w|', + create_function( // l'apice singolo è essenziale qui, // o in alternativa occorre usare la sequenza di escape \$ // per tutte le occorrenze di $ @@ -87,10 +84,10 @@ 'return strtolower($matches[0]);' ), $line - ); - echo $line; - } - fclose($fp); + ); + echo $line; +} +fclose($fp); ?> ]]> </programlisting> Index: phpdoc-it/reference/pcre/functions/preg-replace.xml diff -u phpdoc-it/reference/pcre/functions/preg-replace.xml:1.5 phpdoc-it/reference/pcre/functions/preg-replace.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-replace.xml:1.5 Fri Jul 11 15:55:12 2003 +++ phpdoc-it/reference/pcre/functions/preg-replace.xml Sun Jan 11 15:16:11 2004 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.5 --> -<!-- last change to 'preg-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> -<!-- OLD-Revision: 1.78/EN.1.2 --> +<!-- EN-Revision: 1.11 Maintainer: darvina Status: ready --> <refentry id="function.preg-replace"> <refnamediv> <refname>preg_replace</refname> @@ -59,15 +57,18 @@ $string = "April 15, 2003"; $pattern = "/(\w+) (\d+), (\d+)/i"; $replacement = "\${1}1,\$3"; -print preg_replace($pattern, $replacement, $string); - -/* Output - ====== -April1,2003 -*/ +echo preg_replace($pattern, $replacement, $string); ?> ]]> </programlisting> + <para> + This example will output : + </para> + <screen> +<![CDATA[ +April1,2003 +]]> + </screen> </example> </para> <para> @@ -77,7 +78,7 @@ </para> <para> Ogni parametro passato alla funzione <function>preg_replace</function>, - (eccetto <parameter>limite</parameter>) può essere una matrice. + (eccetto <parameter>limite</parameter>) può essere una matrice ad una dimensione. Quando si utilizzano matrici con <parameter>espressione_regolare</parameter> e <parameter>sostituto</parameter>, le chiavi sono processate nell'ordine con cui appaiono nella matrice. Questo @@ -105,33 +106,40 @@ $replacements[1] = "black"; $replacements[0] = "slow"; -print preg_replace($patterns, $replacements, $string); - -/* Output - ====== - +echo preg_replace($patterns, $replacements, $string); +?> +]]> + </programlisting> + <para> + Output: + </para> + <screen> +<![CDATA[ The bear black slow jumped over the lazy dog. - -*/ - -/* utilizzando ksort su entrambe le matrici - otteniamo cio che vogliamo. */ - +]]> + </screen> + <para> + Utilizzando ksort su entrambe le matrici + otteniamo cio che vogliamo. + </para> + <programlisting role="php"> +<![CDATA[ +<?php ksort($patterns); ksort($replacements); -print preg_replace($patterns, $replacements, $string); - -/* Output - ====== - -The slow black bear jumped over the lazy dog. - -*/ - +echo preg_replace($patterns, $replacements, $string); ?> ]]> </programlisting> + <para> + Output : + </para> + <screen> +<![CDATA[ +The slow black bear jumped over the lazy dog. +]]> + </screen> </example> </para> <para> @@ -164,13 +172,13 @@ <para> <example> <title>Esempi di sostituzione di valori</title> - <programlisting> + <programlisting role="php"> <![CDATA[ <?php $patterns = array ("/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/", "/^\s*{(\w+)}\s*=/"); $replace = array ("\\3/\\4/\\1\\2", "$\\1 ="); -print preg_replace ($patterns, $replace, "{startDate} = 1999-5-27"); +echo preg_replace($patterns, $replace, "{startDate} = 1999-5-27"); ?> ]]> </programlisting> @@ -190,7 +198,7 @@ <programlisting role="php"> <![CDATA[ <?php -preg_replace ("/(<\/?)(\w+)([^>]*>)/e", +preg_replace("/(<\/?)(\w+)([^>]*>)/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); ?> @@ -241,7 +249,7 @@ chr(169), "chr(\\1)"); -$text = preg_replace ($search, $replace, $document); +$text = preg_replace($search, $replace, $document); ?> ]]> </programlisting> Index: phpdoc-it/reference/pcre/functions/preg-split.xml diff -u phpdoc-it/reference/pcre/functions/preg-split.xml:1.5 phpdoc-it/reference/pcre/functions/preg-split.xml:1.6 --- phpdoc-it/reference/pcre/functions/preg-split.xml:1.5 Fri Jul 11 15:55:23 2003 +++ phpdoc-it/reference/pcre/functions/preg-split.xml Sun Jan 11 15:16:11 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/pcre.xml, last change in rev 1.1 --> <!-- last change to 'preg-split' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-split"> <refnamediv> @@ -78,7 +78,7 @@ <?php // Suddivide la seguente frase in base alla presenza di virgole, spazi bianchi, // e altri caratteri speciali quali \r, \t, \n ed \f -$keywords = preg_split ("/[\s,]+/", "hypertext language, programming"); +$keywords = preg_split("/[\s,]+/", "hypertext language, programming"); ?> ]]> </programlisting>