cvs: phpdoc-it /reference/regex reference.xml /reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml split.xml spliti.xml
sql-regcase.xml

From: Date: Sun, 11 Jan 2004 20:18:25 +0000
Subject: cvs: phpdoc-it /reference/regex reference.xml /reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml split.xml spliti.xml
sql-regcase.xml
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-509@lists.php.net to get a copy of this message
darvina Sun Jan 11 15:18:25 2004 EDT Modified files: /phpdoc-it/reference/regex reference.xml /phpdoc-it/reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml split.xml spliti.xml sql-regcase.xml Log: Sync to En tree

Index: phpdoc-it/reference/regex/reference.xml diff -u phpdoc-it/reference/regex/reference.xml:1.9 phpdoc-it/reference/regex/reference.xml:1.10 --- phpdoc-it/reference/regex/reference.xml:1.9 Fri Jul 11 15:53:35 2003 +++ phpdoc-it/reference/regex/reference.xml Sun Jan 11 15:18:24 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> <reference id="ref.regex"> <title>Funzioni per le espressioni regolari (POSIX estesa)</title> <titleabbrev>Regexp</titleabbrev> @@ -89,33 +89,33 @@ <?php /* Restituisce vero se "abc" viene trovata ovunque in $string. */ -ereg ("abc", $string); +ereg("abc", $string); /* Restituisce vero se "abc" viene trovata all'inizio di $string. */ -ereg ("^abc", $string); +ereg("^abc", $string); /* Restituisce vero se "abc" viene trovata alla fine di $string. */ -ereg ("abc$", $string); +ereg("abc$", $string); /* Restituisce vero se il browser è Netscape 2, 3 oppure MSIE 3. */ -eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); +eregi("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); /* Posizione tre parole separate da spazio in $regs[1], $regs[2] e $regs[3]. */ -ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); +ereg("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string, $regs); /* Posiziona il tag <br /> all'inizio di $string. */ -$string = ereg_replace ("^", "<br />", $string); +$string = ereg_replace("^", "<br />", $string); /* Posiziona il tag <br /> alla fine di $string. */ -$string = ereg_replace ("$", "<br />", $string); +$string = ereg_replace("$", "<br />", $string); /* Toglie ogni carattere di invio da $string. */ -$string = ereg_replace ("\n", "", $string); +$string = ereg_replace("\n", "", $string); ?> ]]> </programlisting> Index: phpdoc-it/reference/regex/functions/ereg-replace.xml diff -u phpdoc-it/reference/regex/functions/ereg-replace.xml:1.3 phpdoc-it/reference/regex/functions/ereg-replace.xml:1.4 --- phpdoc-it/reference/regex/functions/ereg-replace.xml:1.3 Sat Mar 8 06:49:04 2003 +++ phpdoc-it/reference/regex/functions/ereg-replace.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'ereg-replace' 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.42/EN.1.2 --> <refentry id="function.ereg-replace"> <refnamediv> @@ -16,13 +16,6 @@ <methodparam><type>string</type><parameter>testo_sostitutivo</parameter></methodparam> <methodparam><type>string</type><parameter>stringa</parameter></methodparam> </methodsynopsis> - <note> - <para> - Poichè utilizza espressioni regolari con sintassi compatibile - con Perl, <function>preg_replace</function>, è spesso una alternativa - più veloce a <function>ereg_replace</function>. - </para> - </note> <simpara> La funzione ricerca all'interno del parametro <parameter>stringa</parameter> sottostringhe che incrocino con le condizioni specificate in <parameter> @@ -52,14 +45,18 @@ <para> Come esempio il seguente frammento di codice visualizzerà la frase "Questo fu un test" tre volte: + </para> + <para> <example> - <title><function>ereg_replace</function> Esempio</title> - <programlisting> + <title><function>ereg_replace</function> esempio</title> + <programlisting role="php"> <![CDATA[ +<?php $stringa = "Questo è un test"; -echo ereg_replace (" è", " fu", $stringa); -echo ereg_replace ("( )è", "\\1fu", $stringa); -echo ereg_replace ("(( )è)", "\\2fu", $stringa); +echo ereg_replace(" è", " fu", $stringa); +echo ereg_replace("( )è", "\\1fu", $stringa); +echo ereg_replace("(( )è)", "\\2fu", $stringa); +?> ]]> </programlisting> </example> @@ -71,9 +68,11 @@ Questo accade perchè la funzione <function>ereg_replace</function> interpreta il numero come posizione ordinale di un carattere comportandosi di conseguenza. Ad esempio: + </para> + <para> <example> - <title><function>ereg_replace</function> Esempio</title> - <programlisting> + <title><function>ereg_replace</function> esempio</title> + <programlisting role="php"> <![CDATA[ <?php /* Questo non si comporta come atteso. */ @@ -97,20 +96,29 @@ <title>Sostituzione di URL</title> <programlisting role="php"> <![CDATA[ +<?php $testo = ereg_replace("[[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/]", "<a href=\"\\0\">\\0</a>", $testo); +?> ]]> </programlisting> </example> </para> - <simpara> + <tip> + <para> + Poichè utilizza espressioni regolari con sintassi compatibile + con Perl, <function>preg_replace</function>, è spesso una alternativa + più veloce a <function>ereg_replace</function>. + </para> + </tip> + <para> Vedere anche <function>ereg</function>, <function>eregi</function>, <function>eregi_replace</function>, <function>str_replace</function> e <function>preg_match</function>. - </simpara> + </para> </refsect1> </refentry> Index: phpdoc-it/reference/regex/functions/ereg.xml diff -u phpdoc-it/reference/regex/functions/ereg.xml:1.4 phpdoc-it/reference/regex/functions/ereg.xml:1.5 --- phpdoc-it/reference/regex/functions/ereg.xml:1.4 Sat Mar 15 07:25:13 2003 +++ phpdoc-it/reference/regex/functions/ereg.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'ereg' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.42/EN.1.2 --> <refentry id="function.ereg"> <refnamediv> @@ -25,7 +25,8 @@ </note> <simpara> Ricerca in <parameter>stringa</parameter> testi che possano incrociarsi - con l'espressione regolare indicata in <parameter>espressione_regolare</parameter>. + con l'espressione regolare indicata in <parameter>espressione_regolare</parameter> distinguendo tra + lettere minuscole e maiuscole. </simpara> <simpara> Se le parti di testo poste tra parentesi nel campo @@ -40,7 +41,7 @@ </simpara> <note> <simpara> - Fino alla versione di PHP 4.1.0 compresa, <literal>$regs</literal> + Fino alla versione di PHP 4.1.0 compresa, <varname>$regs</varname> conterrà esattamente 10 elementi, anche se il numero delle stringhe riconosciute sia maggiore o minore di 10. Ciò non limita <function>ereg</function> nella ricerca di più sottostringhe. @@ -49,9 +50,6 @@ </simpara> </note> <simpara> - La ricerca è sensibile alle lettere maiuscole e minuscole. - </simpara> - <simpara> La funzione ritorna &true; se le ricerche previste da <parameter>espressione_regolare</parameter> sono riscontrate in <parameter>stringa</parameter>. Viene restituito &false; se non @@ -60,6 +58,8 @@ <para> Nel seguente frammento di codice, una data in formato ISO (YYYY-MM-DD) verrà visualizzata nel formato DD.MM.YYYY: + </para> + <para> <example> <title>Esempio dell'uso di <function>ereg</function> Esempio</title> <programlisting role="php"> Index: phpdoc-it/reference/regex/functions/eregi-replace.xml diff -u phpdoc-it/reference/regex/functions/eregi-replace.xml:1.2 phpdoc-it/reference/regex/functions/eregi-replace.xml:1.3 --- phpdoc-it/reference/regex/functions/eregi-replace.xml:1.2 Wed Apr 17 03:08:18 2002 +++ phpdoc-it/reference/regex/functions/eregi-replace.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'eregi-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.42/EN.1.2 --> <refentry id="function.eregi-replace"> <refnamediv> Index: phpdoc-it/reference/regex/functions/eregi.xml diff -u phpdoc-it/reference/regex/functions/eregi.xml:1.4 phpdoc-it/reference/regex/functions/eregi.xml:1.5 --- phpdoc-it/reference/regex/functions/eregi.xml:1.4 Mon Feb 24 15:28:14 2003 +++ phpdoc-it/reference/regex/functions/eregi.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'eregi' 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.42/EN.1.2 --> <refentry id="function.eregi"> <refnamediv> @@ -20,6 +20,8 @@ Questa funzione è identica a <function>ereg</function>, tranne che per il fatto che non distingue tra lettere maiuscole e lettere minuscole. + </para> + <para> <example> <title>Esempio di <function>eregi</function></title> <programlisting role="php"> Index: phpdoc-it/reference/regex/functions/split.xml diff -u phpdoc-it/reference/regex/functions/split.xml:1.2 phpdoc-it/reference/regex/functions/split.xml:1.3 --- phpdoc-it/reference/regex/functions/split.xml:1.2 Wed Apr 17 03:08:19 2002 +++ phpdoc-it/reference/regex/functions/split.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.3 --> <!-- last change to 'split' in en/ tree in rev 1.7 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.42/EN.1.7 --> <refentry id="function.split"> <refnamediv> @@ -16,18 +16,20 @@ <methodparam><type>string</type><parameter>stringa</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>limite</parameter></methodparam> </methodsynopsis> - <note> + <tip> <para> Poichè utilizza espressioni regolari con sintassi compatibile con Perl, <function>preg_split</function>, è spesso una alternativa - più veloce a <function>split</function>. + più veloce a <function>split</function>. Se non si ha necessità delle capacità + delle espressioni regolari, è più veloce l'utilizzo di <function>explode</function>, che non + richiede l'overhead del motore delle espressioni regolari. </para> - </note> + </tip> <para> La funzione restituisce una matrice di stringhe che sono delle sottostringhe del parametro <parameter>stringa</parameter>. Queste sono ottenute suddividendo il parametro secondo i limiti indicati - dal parametro <parameter>espressione_regolare</parameter>. Se viene + dal parametro sensibile alle maiuscole <parameter>espressione_regolare</parameter>. Se viene specificato il parametro <parameter>limite</parameter>, la funzione restituisce una matrice con un numero di elementi al massimo pari a <parameter>limite</parameter>. L'ultimo elemento della matrice contiene @@ -38,53 +40,48 @@ <para> Esempio di come estrapolare i primi 4 campi da una linea del file <filename>/etc/passwd</filename>: + </para> + <para> <example> <title>Esempio di <function>split</function></title> <programlisting role="php"> <![CDATA[ -list($user,$pass,$uid,$gid,$extra)= split (":", $passwd_line, 5); +<?php +list($user, $pass, $uid, $gid, $extra) = split(":", $passwd_line, 5); +?> ]]> </programlisting> </example> </para> - <note> - <simpara> - Se nella stringa passata vi sono <replaceable>n</replaceable> occorrenze - del parametro <parameter>espressione_regolare</parameter>, la matrice restituita - conterrà <literal><replaceable>n</replaceable>+1</literal> elementi. - Invece, nel caso in cui non vi siano occorrenze della - <parameter>espressione_regolare</parameter>, la matrice restituita conterrà - un solo elemento. Ovviamente questo è valido anche nel caso in cui il - parametro <parameter>stringa</parameter> è vuoto. - </simpara> - </note> + <simpara> + Se nella stringa passata vi sono <replaceable>n</replaceable> occorrenze + del parametro <parameter>espressione_regolare</parameter>, la matrice restituita + conterrà <literal><replaceable>n</replaceable>+1</literal> elementi. + Invece, nel caso in cui non vi siano occorrenze della + <parameter>espressione_regolare</parameter>, la matrice restituita conterrà + un solo elemento. Ovviamente questo è valido anche nel caso in cui il + parametro <parameter>stringa</parameter> è vuoto. + </simpara> <para> Nell'esempio che segue, si vedrà come analizzare una data il cui testo può contenere barre, punti o trattini: + </para> + <para> <example> - <title><function>split</function> Esempio</title> + <title><function>split</function> esempio</title> <programlisting role="php"> <![CDATA[ -$data = "04/30/1973"; // Delimitatori di testo: barre, punti, trattini +// Delimitatori di testo: barre, punti, trattini +$data = "04/30/1973"; list ($mese, $giorno, $anno) = split ('[/.-]', $data); echo "Mese: $mese; Giorno: $giorno; Anno: $anno<br>\n"; +?> ]]> </programlisting> </example> </para> <para> - Fare attenzione al fatto che <parameter>espressione_regolare</parameter> è distingue - tra lettere maiuscole e minuscole. - </para> - - <para> - Nota: se non è richiesta la potenza delle espressioni regolari, - è più veloce la funzione <function>explode</function>, la quale - non richiede l'uso del motore delle espressioni regolari. - </para> - - <para> Gli utenti che cercano un modo di emulare il comportamento di Perl <command>@chars = split('', $str)</command>, sono rimandati agli esempi di <function>preg_split</function>. Index: phpdoc-it/reference/regex/functions/spliti.xml diff -u phpdoc-it/reference/regex/functions/spliti.xml:1.2 phpdoc-it/reference/regex/functions/spliti.xml:1.3 --- phpdoc-it/reference/regex/functions/spliti.xml:1.2 Wed Apr 17 03:08:19 2002 +++ phpdoc-it/reference/regex/functions/spliti.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'spliti' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.42/EN.1.2 --> <refentry id="function.spliti"> <refnamediv> @@ -13,12 +13,12 @@ </refnamediv> <refsect1> <title>Descrizione</title> - <methodsynopsis> - <type>array</type><methodname>spliti</methodname> - <methodparam><type>string</type><parameter>espressione_regolare</parameter></methodparam> - <methodparam><type>string</type><parameter>stringa</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>limite</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>spliti</methodname> + <methodparam><type>string</type><parameter>espressione_regolare</parameter></methodparam> + <methodparam><type>string</type><parameter>stringa</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>limite</parameter></methodparam> + </methodsynopsis> <para> Questa funzione ha un comportamento identico a <function>split</function> tranne che per il fatto di non distinguere tra lettere maiuscole e minuscole. Index: phpdoc-it/reference/regex/functions/sql-regcase.xml diff -u phpdoc-it/reference/regex/functions/sql-regcase.xml:1.2 phpdoc-it/reference/regex/functions/sql-regcase.xml:1.3 --- phpdoc-it/reference/regex/functions/sql-regcase.xml:1.2 Wed Apr 17 03:08:19 2002 +++ phpdoc-it/reference/regex/functions/sql-regcase.xml Sun Jan 11 15:18:25 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/regex.xml, last change in rev 1.1 --> <!-- last change to 'sql-regcase' 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.42/EN.1.2 --> <refentry id="function.sql-regcase"> <refnamediv> @@ -21,19 +21,24 @@ sia in grado di riconoscere il parametro <parameter> stringa</parameter>, a prescindere dalle lettere maiuscole minuscole. L'espressione regolare restituita corrisponde - a <parameter>string</parameter> con ciascun carattere riportato + a <parameter>stringa</parameter> con ciascun carattere alfabetico riportato tra parentesi. Ogni parentesi contiene il singolo carattere - in maiuscolo ed in minuscolo. Se il carattere non esiste in forma - minuscola o maiuscola, il carattere originale vie riportato due volte. + in maiuscolo ed in minuscolo. I rimanenti caratteri sono riportati + immutati. <example> - <title><function>sql_regcase</function> Esempio</title> + <title><function>sql_regcase</function> esempio</title> <programlisting role="php"> <![CDATA[ -echo sql_regcase ("Foo bar"); +<?php +echo sql_regcase("Foo bar"); +?> ]]> </programlisting> + <para> + visualizza: + </para> + <screen>[Ff][Oo][Oo] - [Bb][Aa][Rr].</screen> </example> - visualizza <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen>. </para> <para> Questa funzione torna utile quando si devono ottenere espressioni regolari
« previous php.doc.it (#509) next »