cvs: phpdoc-it /reference/pcre/functions preg-match-all.xml preg-match.xml preg-split.xml

darvina Mon Jun 17 16:27:28 2002 EDT Modified files: /phpdoc-it/reference/pcre/functions preg-match.xml preg-match-all.xml preg-split.xml Log: Update to En 1.4

Index: phpdoc-it/reference/pcre/functions/preg-match.xml diff -u phpdoc-it/reference/pcre/functions/preg-match.xml:1.3 phpdoc-it/reference/pcre/functions/preg-match.xml:1.4 --- phpdoc-it/reference/pcre/functions/preg-match.xml:1.3 Wed May 15 15:44:51 2002 +++ phpdoc-it/reference/pcre/functions/preg-match.xml Mon Jun 17 16:27:27 2002 @@ -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.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match"> <refnamediv> @@ -15,6 +15,7 @@ <methodparam><type>string </type><parameter>criterio</parameter></methodparam> <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> </methodsynopsis> <para> Esegue un riconoscimento nel parametro <parameter>testo</parameter> utilizzando @@ -26,6 +27,27 @@ si incrocia con l'intero criterio di ricerca, $testi_riconosciuti[1] conterrà il testo che soddisfa il primo criterio posto tra parentesi, $testi_riconosciuti[2] il secondo e così via. </para> + <para> + Il parametro <parameter>flags</parameter> può assumere i seguenti valori: + <variablelist> + <varlistentry> + <term>PREG_OFFSET_CAPTURE</term> + <listitem> + <simpara> + Se viene impostato questo flag, per ogni testo riconosciuto viene restituito + l'offset della stringa. Occorre notare che questo cambia il tipo di valore + restituito nell'array, infatti ogni elemento è, a sua volta, un'array composto dalla + stringa riconosciuta, all'indice <literal>0</literal>, e dall'offset della stringa nell'indice + <literal>1</literal>. Questa costante è disponibile a partire dalla + versione 4.3.0 di <literal>PHP</literal>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + Il parametro <parameter>flags</parameter> è disponibile a partire dalla versione 4.3.0 + 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 Index: phpdoc-it/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.3 phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.4 --- phpdoc-it/reference/pcre/functions/preg-match-all.xml:1.3 Wed May 15 15:37:10 2002 +++ phpdoc-it/reference/pcre/functions/preg-match-all.xml Mon Jun 17 16:27:28 2002 @@ -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.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-match-all"> <refnamediv> @@ -15,7 +15,7 @@ <methodparam><type>string </type><parameter>espressione_regolare</parameter></methodparam> <methodparam><type>string </type><parameter>testo</parameter></methodparam> <methodparam><type>array </type><parameter>TestiRiconosciuti</parameter></methodparam> - <methodparam choice="opt"><type>int </type><parameter>ordine</parameter></methodparam> + <methodparam choice="opt"><type>int </type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> La funzione ricerca tutte le espressioni regolari passate nel parametro <parameter>espressione_regolare</parameter> all'interno @@ -28,7 +28,10 @@ saranno effettuate a partire dall'ultima ricerca specificata. </para> <para> - <parameter>ordine</parameter> può assumere uno dei due valori seguenti: + Il parametro <parameter>flags</parameter> può essere la combinazione dei seguenti flag + (da notare che non ha senso utilizzare + <constant>PREG_PATTERN_ORDER</constant> in unione a + <constant>PREG_SET_ORDER</constant>): <variablelist> <varlistentry> <term>PREG_PATTERN_ORDER</term> @@ -36,9 +39,9 @@ <para> I testi riconosciuti saranno organizzati in modo tale da avere in $TestiRiconosciuti[0] la matrice di tutti i testi riconosciuti, - in $TestiRiconosciuti[1] la matrice di tutti i testi che soddisfano + in $TestiRiconosciuti[1] la matrice di tutti i testi che soddisfino il primo criterio di riconoscimento posto tra parentesi tonde, in - $TestiRiconosciuti[2] si avranno i testi che soddisfano il secondo + $TestiRiconosciuti[2] si avranno i testi che soddisfino il secondo criterio e cosi via. <informalexample> <programlisting role="php"> @@ -104,10 +107,23 @@ </para> </listitem> </varlistentry> + <varlistentry> + <term>PREG_OFFSET_CAPTURE</term> + <listitem> + <para> + Se viene impostato questo flag, per ogni testo riconosciuto viene restituito + l'offset della stringa. Occorre notare che questo cambia il tipo di valore + restituito nell'array, infatti ogni elemento è, a sua volta, un'array composto dalla + stringa riconosciuta, all'indice <literal>0</literal>, e dall'offset della stringa nell'indice + <literal>1</literal>. Questa costante è disponibile a partire dalla + versione 4.3.0 di <literal>PHP</literal>. + </para> + </listitem> + </varlistentry> </variablelist> </para> <para> - Qualora non si specifichi il parametro <parameter>ordine</parameter>, + Qualora non si specifichi il parametro <parameter>flags</parameter>, si assume per default il valore PREG_PATTERN_ORDER. </para> <para> Index: phpdoc-it/reference/pcre/functions/preg-split.xml diff -u phpdoc-it/reference/pcre/functions/preg-split.xml:1.2 phpdoc-it/reference/pcre/functions/preg-split.xml:1.3 --- phpdoc-it/reference/pcre/functions/preg-split.xml:1.2 Wed Apr 17 03:08:01 2002 +++ phpdoc-it/reference/pcre/functions/preg-split.xml Mon Jun 17 16:27:28 2002 @@ -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.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.78/EN.1.2 --> <refentry id="function.preg-split"> <refnamediv> @@ -51,6 +51,19 @@ </simpara> </listitem> </varlistentry> + <varlistentry> + <term>PREG_SPLIT_OFFSET_CAPTURE</term> + <listitem> + <para> + Se viene impostato questo flag, per ogni testo riconosciuto viene restituito + l'offset della stringa. Occorre notare che questo cambia il tipo di valore + restituito nell'array; infatti ogni elemento è, a sua volta, un'array composto dalla + stringa riconosciuta, all'indice <literal>0</literal>, e dall'offset della stringa nell'indice + <literal>1</literal>. Questa costante è disponibile a partire dalla + versione 4.3.0 di <literal>PHP</literal>. + </para> + </listitem> + </varlistentry> <varlistentry> <term>PREG_SPLIT_DELIM_CAPTURE</term> <listitem> @@ -85,6 +98,46 @@ print_r($chars); ]]> </programlisting> + </example> + </para> + <para> + <example> + <title>Suddivisione di una stringa in testi riconosciuti con i relativi offset.</title> + <programlisting role="php"> +<![CDATA[ +$str = 'hypertext language programming'; +$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE); +print_r($chars); +]]> + </programlisting> + <para> + visualizzerà + </para> + <screen> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => hypertext + [1] => 0 + ) + + [1] => Array + ( + [0] => language + [1] => 10 + ) + + [2] => Array + ( + [0] => programming + [1] => 19 + ) + +) +]]> + </screen> </example> </para> <para>