cvs: phpdoc-it /reference/iconv reference.xml /reference/math/functions acos.xml acosh.xml /reference/overload configure.xml reference.xml
/reference/overload/functions overload.xml /reference/pcre pattern.modifiers.xml pattern.syntax.xml reference.xml /reference/pcre/functions
preg-quote.xml /reference/strings/functions hebrev.xml html-entity-decode.xml htmlentities.xml htmlspecialchars.xml implode.xml join.xml
levenshtein.xml localeconv.xml ltrim.xml md5-file.xml md5.xml metaphone.xml

From:	Andrioli Darvin	Date:	Mon, 02 Aug 2004 12:03:59 +0000
Subject:	cvs: phpdoc-it /reference/iconv reference.xml /reference/math/functions acos.xml acosh.xml /reference/overload configure.xml reference.xml /reference/overload/functions overload.xml /reference/pcre pattern.modifiers.xml pattern.syntax.xml reference.xml /reference/pcre/functions preg-quote.xml /reference/strings/functions hebrev.xml html-entity-decode.xml htmlentities.xml htmlspecialchars.xml implode.xml join.xml levenshtein.xml localeconv.xml ltrim.xml md5-file.xml md5.xml metaphone.xml
Groups:	php.doc.it
Request:	Send a blank email to doc-it+get-626@lists.php.net to get a copy of this message

darvina Mon Aug 2 08:03:59 2004 EDT Added files: /phpdoc-it/reference/overload configure.xml /phpdoc-it/reference/strings/functions html-entity-decode.xml htmlspecialchars.xml implode.xml join.xml levenshtein.xml localeconv.xml ltrim.xml md5-file.xml md5.xml metaphone.xml Modified files: /phpdoc-it/reference/iconv reference.xml /phpdoc-it/reference/math/functions acos.xml acosh.xml /phpdoc-it/reference/overload reference.xml /phpdoc-it/reference/overload/functions overload.xml /phpdoc-it/reference/pcre pattern.modifiers.xml pattern.syntax.xml reference.xml /phpdoc-it/reference/pcre/functions preg-quote.xml /phpdoc-it/reference/strings/functions hebrev.xml htmlentities.xml Log: Sync to En tree some chapter reference

http://cvs.php.net/diff.php/phpdoc-it/reference/iconv/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/iconv/reference.xml diff -u phpdoc-it/reference/iconv/reference.xml:1.4 phpdoc-it/reference/iconv/reference.xml:1.5 --- phpdoc-it/reference/iconv/reference.xml:1.4 Thu Jul 29 08:21:26 2004 +++ phpdoc-it/reference/iconv/reference.xml Mon Aug 2 08:03:58 2004 @@ -21,7 +21,7 @@ </para> <para> - Dalla versione 5.0.0 di <application>PHP</application> 5.0.0, questa versione viene rilasciata + Dalla versione 5.0.0 di <application>PHP</application>, questa versione viene rilasciata con diverse funzioni che aiutano a realizzare script in più lingue. Guardare nelle sezioni seguenti per scoprire queste nuove caratteristiche. http://cvs.php.net/diff.php/phpdoc-it/reference/math/functions/acos.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/math/functions/acos.xml diff -u phpdoc-it/reference/math/functions/acos.xml:1.3 phpdoc-it/reference/math/functions/acos.xml:1.4 --- phpdoc-it/reference/math/functions/acos.xml:1.3 Fri Oct 3 15:27:43 2003 +++ phpdoc-it/reference/math/functions/acos.xml Mon Aug 2 08:03:58 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <refentry id="function.acos"> <refnamediv> <refname>acos</refname> @@ -18,8 +18,10 @@ per ciascun valore di a nel range di <function>acos</function>. </para> <para> - Vedere anche <parameter>arg</parameter>, <function>asin</function> - e <function>atan</function>. + Vedere anche: + <function>acosh</function>, + <function>asin</function> e + <function>atan</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/math/functions/acosh.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/math/functions/acosh.xml diff -u phpdoc-it/reference/math/functions/acosh.xml:1.3 phpdoc-it/reference/math/functions/acosh.xml:1.4 --- phpdoc-it/reference/math/functions/acosh.xml:1.3 Fri Oct 3 15:27:43 2003 +++ phpdoc-it/reference/math/functions/acosh.xml Mon Aug 2 08:03:58 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <refentry id="function.acosh"> <refnamediv> <refname>acosh</refname> @@ -18,7 +18,8 @@ </para> &note.no-windows; <para> - Vedere anche <function>acos</function>, <function>asinh</function> + Vedere anche <function>acos</function>, + <function>asinh</function> e <function>atanh</function>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/overload/reference.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/overload/reference.xml diff -u phpdoc-it/reference/overload/reference.xml:1.2 phpdoc-it/reference/overload/reference.xml:1.3 --- phpdoc-it/reference/overload/reference.xml:1.2 Mon Apr 29 17:31:05 2002 +++ phpdoc-it/reference/overload/reference.xml Mon Aug 2 08:03:58 2004 @@ -1,24 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.overload"> <title>Proprietà object e method call overloading</title> <titleabbrev>Overloading degli object</titleabbrev> - <partintro id="overload.partintro"> - &warn.experimental; - <para> - Lo scopo di questa estensione è di permettere l'overloading delle proprietà - di accesso agli oggetti e dei metodi di chiamata. Solo una funzione è definita - in questa estensione, <function>overload</function> che prende il - nome dalla classe che ha questa funzionalità abilitata. - La classe nominata ha da definire metodi appropriati se - vuole avere questa funzionalità: <literal>__get()</literal>, - <literal>__set()</literal> and <literal>__call()</literal> - rispettivamente per ricevere/impostare una proprietà, o chiamare un metodo. - Questa strada del sovraccarico può essere selettiva. Dentro queste - funzioni handler l'overloading è disabilitato così si può accedere - alle proprietà dell'oggetto normalmente. - </para> + <partintro> + + <section id="overload.intro"> + &reftitle.intro; + <para> + Lo scopo di questa estensione è di permettere l'overloading delle proprietà + di accesso agli oggetti e dei metodi di chiamata. Solo una funzione è definita + in questa estensione, <function>overload</function> che prende il + nome dalla classe che ha questa funzionalità abilitata. + La classe nominata ha da definire metodi appropriati se + vuole avere questa funzionalità: <literal>__get()</literal>, + <literal>__set()</literal> and <literal>__call()</literal> + rispettivamente per ricevere/impostare una proprietà, o chiamare un metodo. + Questa strada del sovraccarico può essere selettiva. Dentro queste + funzioni handler l'overloading è disabilitato così si può accedere + alle proprietà dell'oggetto normalmente. + </para> + &warn.experimental; + <warning> + <para> + Questo modulo non è parte di PHP 5. Php 5 gestisce le chiamate <literal>__get()</literal>, <literal>__set()</literal> and + <literal>__call()</literal> in modo nativo. Vedere la pagina <link + linkend="language.oop5.overloading">l'overload in PHP 5</link> + per maggiori dettagli. + </para> + </warning> + </section> + + <section id="overload.requirements"> + &reftitle.required; + &no.requirement; + </section> + + &reference.overload.configure; + + <section id="overload.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="overload.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="overload.constants"> + &reftitle.constants; + &no.constants; + </section> + + <section id="overload.examples"> + &reftitle.examples; + <para> Alcuni semplici esempi sull'uso della funzione <function>overload</function> @@ -28,8 +66,7 @@ <![CDATA[ <?php -class OO -{ +class OO { var $a = 111; var $elem = array('b' => 9, 'c' => 42); @@ -56,10 +93,10 @@ overload('OO'); $o = new OO; -print "\$o->a: $o->a\n"; // print: $o->a: -print "\$o->b: $o->b\n"; // print: $o->b: 9 -print "\$o->c: $o->c\n"; // print: $o->c: 42 -print "\$o->d: $o->d\n"; // print: $o->d: +echo "\$o->a: $o->a\n"; // print: $o->a: +echo "\$o->b: $o->b\n"; // print: $o->b: 9 +echo "\$o->c: $o->c\n"; // print: $o->c: 42 +echo "\$o->d: $o->d\n"; // print: $o->d: // add a new item to the $elem array in OO $o->x = 56; @@ -77,20 +114,9 @@ ?> ]]> </programlisting> - </example> - </para> - <warning> - <para> - Siccome è una estensione sperimentale, non tutto - funziona. Non c'è attualmente il supporto per - <literal>__call()</literal>, - puoi solo overloadare le operazioni di ricezione e di impostazione - per le proprietà. Non puoi invocare l'overloading - handlers originale della classe, e - <literal>__set()</literal> funziona solo su un livello - di proprietà di accesso. + </example> </para> - </warning> + </section> </partintro> &reference.overload.functions; http://cvs.php.net/diff.php/phpdoc-it/reference/overload/functions/overload.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/overload/functions/overload.xml diff -u phpdoc-it/reference/overload/functions/overload.xml:1.2 phpdoc-it/reference/overload/functions/overload.xml:1.3 --- phpdoc-it/reference/overload/functions/overload.xml:1.2 Wed Apr 17 03:07:53 2002 +++ phpdoc-it/reference/overload/functions/overload.xml Mon Aug 2 08:03:58 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?>   - +  <refentry id="function.overload"> <refnamediv> @@ -18,7 +18,7 @@ La funzione <function>overload</function> abiliterà la proprietà e il method call overloading per una classe identificata dal parametro <parameter>class_name</parameter>. - <link linkend="overload.partintro">Guarda un esempio + <link linkend="overload.examples">Guarda un esempio nella sezione di introduzione di questa parte.</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/pcre/pattern.modifiers.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/pcre/pattern.modifiers.xml diff -u phpdoc-it/reference/pcre/pattern.modifiers.xml:1.1 phpdoc-it/reference/pcre/pattern.modifiers.xml:1.2 --- phpdoc-it/reference/pcre/pattern.modifiers.xml:1.1 Sun Apr 4 15:38:10 2004 +++ phpdoc-it/reference/pcre/pattern.modifiers.xml Mon Aug 2 08:03:58 2004 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?>   - +  - <refentry id="pcre.pattern.modifiers"> + <refentry id="reference.pcre.pattern.modifiers"> <refnamediv> <refname>Modificatori di criterio (Pattern Modifiers)</refname> <refpurpose>Questo capitolo descrive i possibili modificatori http://cvs.php.net/diff.php/phpdoc-it/reference/pcre/pattern.syntax.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/pcre/pattern.syntax.xml diff -u phpdoc-it/reference/pcre/pattern.syntax.xml:1.1 phpdoc-it/reference/pcre/pattern.syntax.xml:1.2 --- phpdoc-it/reference/pcre/pattern.syntax.xml:1.1 Sun Apr 4 15:38:10 2004 +++ phpdoc-it/reference/pcre/pattern.syntax.xml Mon Aug 2 08:03:58 2004 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?>   - +  - <refentry id="pcre.pattern.syntax"> + <refentry id="reference.pcre.pattern.syntax"> <refnamediv> <refname>Sintassi delle espressioni regolari</refname> <refpurpose>Descrizione della sintassi utilizzata da PCRE @@ -139,21 +139,21 @@ </listitem> <listitem> <simpara> - Se viene settato <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> - e non viene attivato <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>, + Se viene settato <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> + e non viene attivato <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link>, il meta-carattere $ indica soltanto la fine della stringa. </simpara> </listitem> <listitem> <simpara> - Se si attiva <link linkend="pcre.pattern.modifiers">PCRE_EXTRA</link>, + Se si attiva <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link>, un carattere backslash (\) seguito da una lettera che non abbia un significato speciale genera un errore. </simpara> </listitem> <listitem> <simpara> - Se si attiva <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link>, + Se si attiva <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link>, si inverte la "voracità" delle occorrenze, in modo da non essere voraci per default, ma lo tornano ad essere se seguiti da "?". @@ -383,7 +383,7 @@ </para> <para> Se nel criterio di riconoscimento si specifica l'opzione - <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>, + <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link>, lo spazio bianco (diversamente da quando si trova all'interno di una classe di caratteri), e i caratteri posti tra "#" e un "a capo" all'esterno di una classe di caratteri sono ignorati. @@ -772,8 +772,8 @@ di seguito) per il fatto di identificare sempre l'inizio o la fine della stringa oggetto di ricerca a prescindere da quale opzione sia stata attivata. Infatti queste asserzioni non sono - alterate da <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> - oppure da <link linkend="pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link>. + alterate da <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> + oppure da <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link>. La differenza tra <literal>\Z</literal> e <literal>\z</literal> consiste nel fatto che <literal>\Z</literal> identifica sia il carattere precedente il newline posto al termine della stringa sia la fine della @@ -817,13 +817,13 @@ <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> + attivando il flag <link linkend="reference.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 + dall'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link>. Quando viene attivata, questi caratteri identificano rispettivamente, oltre ai tradizionali inizio e fine testo, la lettera immediatamente successiva ed immediatamente precedente il carattere "\n" presente @@ -831,15 +831,15 @@ criterio /^abc$/ riconosce il testo "def\nabc" solo in modalità multi-linea. Di conseguenza i criteri di riconoscimento che 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> . + multi-linea. L'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> + viene ignorata se si attiva il flag <link linkend="reference.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>. + a prescindere che sia attivata o meno l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link>. </para> </refsect2> @@ -849,7 +849,7 @@ 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 - abilita l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> + abilita l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link> si avrà anche il riconoscimento del carattere "a capo". La gestione del simbolo "." è svincolata dalla gestione dei simboli "^" ed "$", l'unica relazione che possono avere riguarda @@ -900,7 +900,7 @@ <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>. + dalle opzioni <link linkend="reference.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> @@ -975,8 +975,8 @@ <refsect2 id="regexp.reference.internal-options"> <title>Settaggio delle opzioni interne</title> <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> + Le opzioni <link linkend="reference.pcre.pattern.modifiers">PCRE_CASELESS</link>, <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> , + <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="reference.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 @@ -987,19 +987,19 @@ <tbody> <row> <entry><literal>i</literal></entry> - <entry> per <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link></entry> + <entry> per <link linkend="reference.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> + <entry>per <link linkend="reference.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> + <entry>per <link linkend="reference.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> + <entry>per <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link></entry> </row> </tbody> </tgroup> @@ -1010,8 +1010,8 @@ tra lettere maiuscole e minuscole e la modalità multi-linea. E' anche possibile disabilitare queste opzioni facendo precedere la lettera dal segno meno (-), o combinare l'attivazione con la - disattivazione come nel caso (?im-sx), in cui si attiva <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> e - <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>. + disattivazione come nel caso (?im-sx), in cui si attiva <link linkend="reference.pcre.pattern.modifiers">PCRE_CASELESS</link> e + <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> e si disattiva <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link> e <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link>. Se la lettera compare sia prima che dopo il segno meno (-) l'opzione resta disabilitata. </para> @@ -1031,7 +1031,7 @@ abc(?i) </literallayout> <para> - In questi esempi si attiva <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> + In questi esempi si attiva <link linkend="reference.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). @@ -1048,7 +1048,7 @@ <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). + <link linkend="reference.pcre.pattern.modifiers">PCRE_CASELESS</link> non sia usato). Da ciò deriva che le opzioni possono avere comportamenti differenti nelle varie parti del criterio di riconoscimento. Ogni variazione apportata ad una ramo alternativo del criterio viene estesa alle @@ -1063,7 +1063,7 @@ 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> + Le opzioni specifiche di PCRE <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> e <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> possono essere variate nel medesimo modo delle opzioni Perl compatibili, utilizzando rispettivamente i caratteri U e X. Il flag (?X) è particolare poiché deve comparire @@ -1274,7 +1274,7 @@ dell'intero criterio. </para> <para> - Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> + Se si attiva l'opzione <link linkend="reference.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 @@ -1289,7 +1289,7 @@ </para> <para> Se un criterio inizia con .* oppure .{0,} e si è attivata - l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> + l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link> (equivalente al /s di Perl), permettendo al . di identificare il carattere di "a capo", si dice che il criterio è implicitamente ancorato, perché qualsiasi elemento che segue sarà confrontato @@ -1299,7 +1299,7 @@ PCRE tratta tale criterio come se fosse preceduto dalla sequenza \A. Nei casi in cui è noto a priori che la stringa oggetto di ricerca non contiene caratteri di "a capo", vale la pena di - attivare l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> + attivare l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link> se il criterio di ricerca inizia con ".*", per ottenere questa ottimizzazione, oppure, in alternativa, usare "^" per indicare in modo esplicito un ancoraggio. @@ -1377,7 +1377,7 @@ (\) sono considerate come parte di un potenziale numero di riferimento. Se il criterio continua con altri caratteri numerici, occorre stabilire un carattere per delimitare il - numero del riferimento. Se si attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> + numero del riferimento. Se si attiva l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link> questo carattere può essere lo spazio. Altrimenti si può usare un commento vuoto. </para> @@ -1696,7 +1696,7 @@ soddisfatta se la sotto-regola di cattura di quel numero è stata precedentemente riconosciuta. Si consideri il seguente criterio contenente degli spazi non significativi per renderlo - più leggibile (si assuma che sia attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>) + più leggibile (si assuma che sia attiva l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link>) e lo si divida in tre parti per praticità di discussione: <literal>( $ )? [^()]+ (?(1) $ )</literal> @@ -1748,7 +1748,7 @@ alcun ruolo nella fase di riconoscimento. </para> <para> - Se viene attivata l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>, + Se viene attivata l'opzione <link linkend="reference.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". @@ -1768,7 +1768,7 @@ la possibilità per i criteri di riconoscimento di essere ricorsivi. Allo scopo è stata definita la sequenza speciale (?R). Il criterio illustrato di seguito risolve il problema delle parentesi - (si assume che l'opzione <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> + (si assume che l'opzione <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTENDED</link> sia attivata in modo da ignorare gli spazi): <literal>$ ( (?>[^()]+) | (?R) )* $</literal> @@ -1836,10 +1836,10 @@ regolari. </para> <para> - Quando un criterio comincia con .* ed è attiva l'opzione <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, il + Quando un criterio comincia con .* ed è attiva l'opzione <link linkend="reference.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 - <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>, PCRE non può + <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link>, PCRE non può fare questa ottimizzazione, perché il meta-carattere . non ri- conosce più il carattere di "a capo", e quindi se la stringa contiene dei caratteri di "a capo", il riconoscimento può par- @@ -1856,7 +1856,7 @@ <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>, + ottenere abilitando <link linkend="reference.pcre.pattern.modifiers">PCRE_DOTALL</link>, oppure iniziando il criterio con ^.* in modo da richiedere un ancoraggio esplicito. Così si risparmia a PCRE di scandirsi il testo alla ricerca di un "a capo" da cui ripartire per la ri- http://cvs.php.net/diff.php/phpdoc-it/reference/pcre/reference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-it/reference/pcre/reference.xml diff -u phpdoc-it/reference/pcre/reference.xml:1.8 phpdoc-it/reference/pcre/reference.xml:1.9 --- phpdoc-it/reference/pcre/reference.xml:1.8 Sun Apr 4 15:40:46 2004 +++ phpdoc-it/reference/pcre/reference.xml Mon Aug 2 08:03:58 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.pcre"> <title>Funzioni per le espressioni regolari (Perl compatibili)</title> <titleabbrev>PCRE</titleabbrev> @@ -15,12 +15,12 @@ usato come delimitatore deve essere utilizzato all'interno dell'espressione, questo deve essere preceduto dal carattere di escape (\). Infine, a partire dalla versione 4.0.4 di PHP, si possono anche usare i delimitatori stile Perl come (), {}, [], ed <>. - Per maggiori dettagli vedere <link linkend="pcre.pattern.syntax">Sintassi dei criteri di riconoscimento</link>. + Per maggiori dettagli vedere <link linkend="reference.pcre.pattern.syntax">Sintassi dei criteri di riconoscimento</link>. </para> <para> Il delimitatore finale può essere seguito da vari modificatori che agiscono sul criterio di riconoscimento. Per maggiori informazioni si rimanda al - capitolo <link linkend="pcre.pattern.modifiers">Modificatori di criterio (Pattern Modifiers)</link>. + capitolo <link linkend="reference.pcre.pattern.modifiers">Modificatori di criterio (Pattern Modifiers)</link>. </para> <para> Utilizzando le <link linkend="ref.regex">funzioni POSIX-esteso</link> http://cvs.php.net/diff.php/phpdoc-it/reference/pcre/functions/preg-quote.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/pcre/functions/preg-quote.xml diff -u phpdoc-it/reference/pcre/functions/preg-quote.xml:1.4 phpdoc-it/reference/pcre/functions/preg-quote.xml:1.5 --- phpdoc-it/reference/pcre/functions/preg-quote.xml:1.4 Sun Jan 11 15:16:11 2004 +++ phpdoc-it/reference/pcre/functions/preg-quote.xml Mon Aug 2 08:03:58 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?>   - +  <refentry id="function.preg-quote"> <refnamediv> @@ -68,6 +68,9 @@ </programlisting> </example> </para> + + &note.bin-safe; + </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/hebrev.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/hebrev.xml diff -u phpdoc-it/reference/strings/functions/hebrev.xml:1.1 phpdoc-it/reference/strings/functions/hebrev.xml:1.2 --- phpdoc-it/reference/strings/functions/hebrev.xml:1.1 Thu Jul 29 08:21:26 2004 +++ phpdoc-it/reference/strings/functions/hebrev.xml Mon Aug 2 08:03:58 2004 @@ -5,7 +5,7 @@ <refnamediv> <refname>hebrev</refname> <refpurpose> - Converte il tetso logico Ebraico in testo visuale + Converte il testo logico Ebraico in testo visuale </refpurpose> </refnamediv> <refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/htmlentities.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/htmlentities.xml diff -u phpdoc-it/reference/strings/functions/htmlentities.xml:1.1 phpdoc-it/reference/strings/functions/htmlentities.xml:1.2 --- phpdoc-it/reference/strings/functions/htmlentities.xml:1.1 Thu Jul 29 08:21:26 2004 +++ phpdoc-it/reference/strings/functions/htmlentities.xml Mon Aug 2 08:03:58 2004 @@ -28,7 +28,7 @@ 'singoli' e "doppi". Sono possibili tre scelte indicate da tre costanti con default <constant>ENT_COMPAT</constant>: <table> - <title>Costantio disponibili per <parameter>quote_style</parameter></title> + <title>Costanti disponibili per <parameter>quote_style</parameter></title> <tgroup cols="2"> <thead> <row> http://cvs.php.net/co.php/phpdoc-it/reference/overload/configure.xml?r=1.1&p=1 Index: phpdoc-it/reference/overload/configure.xml +++ phpdoc-it/reference/overload/configure.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="overload.installation"> &reftitle.install; <para> Per potere utilizzare queste funzioni occorre compilare il PHP con <option role="configure">--enable-overload</option>. A partire dal PHP 4.3.0 questo modulo è abilitato per default. Si può disabilitare il supporto overload tramite <option role="configure">--disable--overload</option>. </para> &windows.builtin; <note> <simpara> Il supporto per questo modulo è compilato per default a partire dal PHP 4.3.0. </simpara> </note> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/html-entity-decode.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/html-entity-decode.xml +++ phpdoc-it/reference/strings/functions/html-entity-decode.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.html-entity-decode"> <refnamediv> <refname>html_entity_decode</refname> <refpurpose> Converte le entità HTML nei corrispondenti caratteri </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>html_entity_decode</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> La funzione <function>html_entity_decode</function> è l'opposto di <function>htmlentities</function> converte tutte le entità HTML presenti nel parametro <parameter>string</parameter> nel corrispondente carattere. </para> <para> Il secondo parametro, <parameter>quote_style</parameter>, opzionale, indica cosa occorre fare per gli apici 'singoli' e "doppi". Sono possibili tre scelte indicate da tre costanti con default <constant>ENT_COMPAT</constant>: <table> <title>Costanti disponibili per <parameter>quote_style</parameter></title> <tgroup cols="2"> <thead> <row> <entry>Nome della costante</entry> <entry>Descrizione</entry> </row> </thead> <tbody> <row> <entry><constant>ENT_COMPAT</constant></entry> <entry>Converte gli apici doppi e lascia inalterati gli apici singoli.</entry> </row> <row> <entry><constant>ENT_QUOTES</constant></entry> <entry>Converte sia gli apici doppi sia gli apici singoli.</entry> </row> <row> <entry><constant>ENT_NOQUOTES</constant></entry> <entry>Lascia entrambi i tipi di apici inalterati.</entry> </row> </tbody> </tgroup> </table> </para> <para> Per il terzo parametro opzionale, <parameter>charset</parameter>, si utilizza come default il set di caratteri ISO-8859-1. Questo parametro indica quale set di caratteri utilizzare per la conversione. </para> &reference.strings.charsets; <para> <example> <title>Decodifica delle entità HTML</title> <programlisting role="php"> <![CDATA[ <?php $orig = "I'll \"walk\" the <b>dog</b> now"; $a = htmlentities($orig); $b = html_entity_decode($a); echo $a; // I'll "walk" the <b>dog</b> now echo $b; // I'll "walk" the <b>dog</b> now // Per utilizzatori di versioni di PHP antecedenti alla 4.3.0: function unhtmlentities($string) { $trans_tbl = get_html_translation_table(HTML_ENTITIES); $trans_tbl = array_flip($trans_tbl); return strtr($string, $trans_tbl); } $c = unhtmlentities($a); echo $c; // I'll "walk" the <b>dog</b> now ?> ]]> </programlisting> </example> </para> <para> <note> <para> Ci si può chiedere come mai la sequenza trim(html_entity_decode('&nbsp;')); non produca una stringa vuota; questo accade perchè l'intità '&nbsp;' non corrisponde al codice ASCII 32 (che verrebbe rimosso da <function>trim</function>), ma, nella codifica di default ISO-8859-1, corrisponde al carattere ASCII 160 (0xa0). </para> </note> </para> <para> Vedere anche <function>htmlentities</function>, <function>htmlspecialchars</function>, <function>get_html_translation_table</function>, and <function>urldecode</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/htmlspecialchars.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/htmlspecialchars.xml +++ phpdoc-it/reference/strings/functions/htmlspecialchars.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.htmlspecialchars"> <refnamediv> <refname>htmlspecialchars</refname> <refpurpose> Converte i caratteri speciali in entità HTML </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>htmlspecialchars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Alcuni caratteri hanno significati particolari in HTML, e, per questo, devono essere rappresentati tramite entità HTML, se devono mantenere il proprio significato. Questa funzione restituisce restituisce una stringa con la conversione di alcuni di questi caratteri; la conversione svolta non è sempre valida nell'ambito della programmazione web. Se occorre l'utilizzo di tutte le entità HTML, utilizzare <function>htmlentities</function>. </para> <simpara> Questa funzione è utile nel prevenire la presenza di marcatori HTML negli input utente, tipo nei forum o nei guest book. Il secondo parametro <parameter>quote_style</parameter>, opzionale, indica alla funzione come comportarsi con gli apici singoli e doppi. La modalità di default è, <constant>ENT_COMPAT</constant>; questa modalità è compatibile con il passato e traduce solo gli apici doppi lasciando inalterati gli apici singoli. Se si imposta <constant>ENT_QUOTES</constant>, entrambi i tipi di apici, singoli e doppi, sono convertiti in entutà e, infine, se si utilizza <constant>ENT_NOQUOTES</constant> ne gli apici singoli ne gli apici doppi sono convertiti in entità. </simpara> <para> La conversioni applicate sono: <itemizedlist> <listitem> <simpara> '&' (e commerciale) diventa '&amp;' </simpara> </listitem> <listitem> <simpara> '"' (doppio apice) diventa '&quot;' con <constant>ENT_NOQUOTES</constant> is not set. </simpara> </listitem> <listitem> <simpara> ''' (singolo apice) diventa '&#039;' soltanto con l'impostazione di <constant>ENT_QUOTES</constant>. </simpara> </listitem> <listitem> <simpara> '<' (minore) diventa '&lt;' </simpara> </listitem> <listitem> <simpara> '>' (maggiore) diventa '&gt;' </simpara> </listitem> </itemizedlist> <example> <title>Esempio di uso di <function>htmlspecialchars</function></title> <programlisting role="php"> <![CDATA[ <?php $new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); echo $new; // <a href='test'>Test</a> ?> ]]> </programlisting> </example> </para> <para> Occorre notare che questa funzione non converte null'altro oltre ai caratteri elencati in precedenza. Per la convertsione di tutte le entità fare riferimento a <function>htmlentities</function>. Il secondo parametro è stato inserito in PHP 3.0.17 e 4.0.3. </para> <para> Il terzo parametro <parameter>charset</parameter> indica quale set di caratteri utilizzare nella conversione. Il set di caratteri di default è ISO-8859-1. Questo terzo parametro è stato aggiunto in PHP 4.1.0. </para> &reference.strings.charsets; <para> Vedere anche <function>get_html_translation_table</function>, <function>strip_tags</function>, <function>htmlentities</function> e <function>nl2br</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/implode.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/implode.xml +++ phpdoc-it/reference/strings/functions/implode.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.implode"> <refnamediv> <refname>implode</refname> <refpurpose>Unisce gli elementi di una matrice in una stringa</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>implode</methodname> <methodparam><type>string</type><parameter>glue</parameter></methodparam> <methodparam><type>array</type><parameter>pieces</parameter></methodparam> </methodsynopsis> <para> Restituisce una stringa contenente tutti gli elementi di una matrice nel medesimo ordine, inserendo il parametro glue tra un elemento e l'altro. <example> <title>Esempio di uso di <function>implode</function></title> <programlisting role="php"> <![CDATA[ <?php $array = array('lastname', 'email', 'phone'); $comma_separated = implode(",", $array); echo $comma_separated; // lastname,email,phone ?> ]]> </programlisting> </example> </para> <note> <para> La funzione <function>implode</function>, per ragioni storiche, può accettare i propri parametri in entrambi gli ordini. Tuttavia per mantenere la consistenza con <function>explode</function>, ed avere meno confusione, utilizzare i parametri nell'ordine documentato. </para> </note> <note> <para> Dal PHP 4.3.0, il parametro glue di <function>implode</function> è opzionale e come default utilizza una stringa vuota (''). Quetso non è l'utilizzo preferenziale di <function>implode</function>. Si suggerisce di utilizzare sempre il secondo parametro per compatibilità cone le vecchie versioni. </para> </note> &note.bin-safe; <simpara> Vedere anche <function>explode</function> e <function>split</function>. </simpara> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/join.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/join.xml +++ phpdoc-it/reference/strings/functions/join.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.join"> <refnamediv> <refname>join</refname> <refpurpose>Alias di <function>implode</function></refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <para> Questa funzione è un alias di <function>implode</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/levenshtein.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/levenshtein.xml +++ phpdoc-it/reference/strings/functions/levenshtein.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.levenshtein"> <refnamediv> <refname>levenshtein</refname> <refpurpose> Calcola la distanza Levenshtein tra due stringhe </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>levenshtein</methodname> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>int</type><methodname>levenshtein</methodname> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam> <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam> <methodparam><type>int</type><parameter>cost_del</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>int</type><methodname>levenshtein</methodname> <methodparam><type>string</type><parameter>str1</parameter></methodparam> <methodparam><type>string</type><parameter>str2</parameter></methodparam> <methodparam><type>function</type><parameter>cost</parameter></methodparam> </methodsynopsis> <para> Questa funzione restituisce la distanza Levenshtein tra due stringhe o -1 se uno degli argomenti è più lungo del limite di 255 caratteri (255 caratteri dovrebbero essere più che sufficienti per il dizionario di confronto, e poi nessuno svolgerebbe seriamente una analisi genetica con il PHP). </para> <para> La distanza Levenshtein è definita come il numero minimo di caratteri da sostituire, inserire o cancellare per trasformare <parameter>str1</parameter> in <parameter>str2</parameter>. La complessità dell'algoritmo è <literal>O(m*n)</literal>, dove <literal>n</literal> e <literal>m</literal> sono rispettivamente la lunghezza di <parameter>str1</parameter> e di <parameter>str2</parameter> (valore piuttosto buono se confrontato con <function>similar_text</function>, che è O(max(n,m)**3), ma comunque costoso). </para> <para> Nella sua versione più semplice la funzione richiede come parametri due stringhe e calcola il numero di caratteri da inserire, sostituire o rimuovere necessari a trasformare <parameter>str1</parameter> in <parameter>str2</parameter>. </para> <para> La seconda variante utilizza tre parametri addizionali che definiscono il costo delle operazioni di inserimento, sostituzione e di cancellazione. Questa versione è più generale e adattabile della precedente, ma non è altrettanto efficiente. </para> <para> La terza versione (che non è ancora implementata) sarè la più generale, ma anche l'alternativa più lenta. Utilizzerà una funzione utente per determinare il costo di ogni possibile operazione. </para> <para> La funzione utente sarà chiamta con i seguenti parametri: <itemizedlist> <listitem> <simpara> operazione da applicare: 'I', 'R' oppure 'D' </simpara> </listitem> <listitem> <simpara> attuale carattere in stringa 1 </simpara> </listitem> <listitem> <simpara> attuale carattere in stringa 2 </simpara> </listitem> <listitem> <simpara> posizione in stringa 1 </simpara> </listitem> <listitem> <simpara> posizione in stringa 2 </simpara> </listitem> <listitem> <simpara> caratteri rimanenti in stringa 1 </simpara> </listitem> <listitem> <simpara> caratteri rimanenti in stringa 2 </simpara> </listitem> </itemizedlist> La funzione utente deve restituire un intero positivo per descrivere il costo della particolare operazione, ma può decidere di utilizzare solo alcuni degli argomenti forniti. </para> <para> L'utilizzo della funzione utente offre la possibilità di tenere conto dell'importanza e/o della differenza tra particolari simboli (caratteri), del contesto in cui questi simboli appaiono, per determinare il costo delle operazioni di inserimento, sostituzione e cancellazione; il tutto al costo della perdita delle ottimizzazioni nell'uso dei regsitri della cpu e della cache fatte per le altre due varianti. </para> <para> Vedere anche <function>soundex</function>, <function>similar_text</function> e <function>metaphone</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/localeconv.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/localeconv.xml +++ phpdoc-it/reference/strings/functions/localeconv.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.localeconv"> <refnamediv> <refname>localeconv</refname> <refpurpose>Ottiene informazioni sul formato numerico</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>localeconv</methodname> <void/> </methodsynopsis> <para> La funzione restituisce un array associativo contenente le configurazioni locali per il formato numerico e monetario. </para> <para> La funzione <function>localeconv</function> restituisce i dati in base alle configurazioni locali come impostate da <function>setlocale</function>. L'array associativo restituito contiene i seguenti campi: <informaltable > <tgroup cols="2"> <thead> <row> <entry>Elemento</entry> <entry>Descrizione</entry> </row> </thead> <tbody> <row> <entry>decimal_point</entry> <entry>Caratetre per il punto decimale</entry> </row> <row> <entry>thousands_sep</entry> <entry>Separatore delle migliaia</entry> </row> <row> <entry>grouping</entry> <entry>Array contenente i gruppi numerici</entry> </row> <row> <entry>int_curr_symbol</entry> <entry>Simbolo internazionale della divisa (i.e. USD)</entry> </row> <row> <entry>currency_symbol</entry> <entry>Simbolo della divisa locale (i.e. $)</entry> </row> <row> <entry>mon_decimal_point</entry> <entry>Carattere per il punto decimale nella moneta</entry> </row> <row> <entry>mon_thousands_sep</entry> <entry>Separatore delle migliaia nella moneta</entry> </row> <row> <entry>mon_grouping</entry> <entry>Array contenente i gruppi monetari</entry> </row> <row> <entry>positive_sign</entry> <entry>Segno per i valori positivi</entry> </row> <row> <entry>negative_sign</entry> <entry>Segno per i valori negativi</entry> </row> <row> <entry>int_frac_digits</entry> <entry>Numero di caratteri frazionali internazionali</entry> </row> <row> <entry>frac_digits</entry> <entry>Numero di caratteri frazionali locali</entry> </row> <row> <entry>p_cs_precedes</entry> <entry> &true; se il simbolo della divisa precede i valori positivi, &false; se segue tali valori </entry> </row> <row> <entry>p_sep_by_space</entry> <entry> &true; se uno spazio separa il simbolo della divisa dai valori positivi &false; in caso contrario </entry> </row> <row> <entry>n_cs_precedes</entry> <entry> &true; se il simbolo della divisa precede i valori negativi, &false; se segue tali valori </entry> </row> <row> <entry>n_sep_by_space</entry> <entry> &true; se uno spazio separa il simbolo della divisa dai valori negativi, &false; in caso contrario </entry> </row> <row valign="top"> <entry>p_sign_posn</entry> <entry> <simplelist columns="2" type="horiz"> <member>0</member> <member> Parentesi attrono alla quantità ed al simbolo della divisa </member> <member>1</member> <member> Il segno precede la quantità ed al simbolo della divisa </member> <member>2</member> <member> Il segno segue la quantità ed al simbolo della divisa </member> <member>3</member> <member> Il segno precede immediatamente il simbolo della divisa </member> <member>4</member> <member> Il segno segue immediatamente il simbolo della divisa </member> </simplelist> </entry> </row> <row valign="top"> <entry>n_sign_posn</entry> <entry> <simplelist columns="2" type="horiz"> <member>0</member> <member> Parentesi attrono alla quantità ed al simbolo della divisa </member> <member>1</member> <member> Il segno precede la quantità ed al simbolo della divisa </member> <member>2</member> <member> Il segno segue la quantità ed al simbolo della divisa </member> <member>3</member> <member> Il segno precede immediatamente il simbolo della divisa </member> <member>4</member> <member> Il segno segue immediatamente il simbolo della divisa </member> </simplelist> </entry> </row> </tbody> </tgroup> </informaltable> </para> <para> I campi di raggruppamento contengono matrici che definiscono il modo con cui i numeri dovrebbero essere raggruppati. Ad esempio, i campi di reggruppamento per il formato en_US, contengono due elementi con i valori 3 e 3. L'indice più alto indica quanto è distinta il gruppo di sinistra. Se un elemento della matrcie è uguale a CHAR_MAX, non vi sono più gruppi. Se nella matrice vi è un elemento a 0, occorre utilizzare l'elemento precedente. </para> <example> <title>Esempio di uso di <function>localeconv</function></title> <programlisting role="php"> <![CDATA[ <?php setlocale(LC_ALL, "en_US"); $locale_info = localeconv(); echo "<pre>\n"; echo "--------------------------------------------\n"; echo " Informazioni sulla configurazione monetaria locale: \n"; echo "--------------------------------------------\n\n"; echo "int_curr_symbol: {$locale_info["int_curr_symbol"]}\n"; echo "currency_symbol: {$locale_info["currency_symbol"]}\n"; echo "mon_decimal_point: {$locale_info["mon_decimal_point"]}\n"; echo "mon_thousands_sep: {$locale_info["mon_thousands_sep"]}\n"; echo "positive_sign: {$locale_info["positive_sign"]}\n"; echo "negative_sign: {$locale_info["negative_sign"]}\n"; echo "int_frac_digits: {$locale_info["int_frac_digits"]}\n"; echo "frac_digits: {$locale_info["frac_digits"]}\n"; echo "p_cs_precedes: {$locale_info["p_cs_precedes"]}\n"; echo "p_sep_by_space: {$locale_info["p_sep_by_space"]}\n"; echo "n_cs_precedes: {$locale_info["n_cs_precedes"]}\n"; echo "n_sep_by_space: {$locale_info["n_sep_by_space"]}\n"; echo "p_sign_posn: {$locale_info["p_sign_posn"]}\n"; echo "n_sign_posn: {$locale_info["n_sign_posn"]}\n"; echo "</pre>\n"; ?> ]]> </programlisting> </example> <para> E' presente una costante, CHAR_MAX, per gli utilizzi descritti in precedenza. </para> <para> Vedere anche <function>setlocale</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/ltrim.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/ltrim.xml +++ phpdoc-it/reference/strings/functions/ltrim.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.ltrim"> <refnamediv> <refname>ltrim</refname> <refpurpose> Rimuove gli spazi dall'inizio di una stringa </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>ltrim</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> </methodsynopsis> <note> <simpara> Il secondo parametro è stato aggiunto nella versione 4.1.0 di PHP </simpara> </note> <para> Questa funzioen restituisce la stringa <parameter>str</parameter> a cui sono stati rimossi gli spazi iniziali. Senza la specifica del secondo parametro <function>ltrim</function> rimuoverà i seguenti caratteri:  <itemizedlist> <listitem> <simpara> " " (<acronym>ASCII</acronym> <literal>32</literal> (<literal>0x20</literal>)), spazio ordinario. </simpara> </listitem> <listitem> <simpara> "\t" (<acronym>ASCII</acronym> <literal>9</literal> (<literal>0x09</literal>)), tab. </simpara> </listitem> <listitem> <simpara> "\n" (<acronym>ASCII</acronym> <literal>10</literal> (<literal>0x0A</literal>)), newline (line feed). </simpara> </listitem> <listitem> <simpara> "\r" (<acronym>ASCII</acronym> <literal>13</literal> (<literal>0x0D</literal>)), carriage return. </simpara> </listitem> <listitem> <simpara> "\0" (<acronym>ASCII</acronym> <literal>0</literal> (<literal>0x00</literal>)), il byte <literal>NUL</literal>. </simpara> </listitem> <listitem> <simpara>  "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> (<literal>0x0B</literal>)), il tab verticale. </simpara> </listitem> </itemizedlist> </para> <para> You can also specify the characters you want to strip, by means of the <parameter>charlist</parameter> parameter. Simply list all characters that you want to be stripped. With <literal>..</literal> you can specify a range of characters. </para> <example> <title>Esempio di uso di <function>ltrim</function></title> <para> <programlisting role="php"> <![CDATA[ <?php $text = "\t\tThese are a few words :) ... "; $trimmed = ltrim($text); // $trimmed = "These are a few words :) ... " $trimmed = ltrim($text, " \t."); // $trimmed = "These are a few words :) ... " $clean = ltrim($binary, "\x00..\x1F"); // rimuove i caratteri di controllo ASCII dall'inizio di $binary // (from 0 to 31 inclusive) ?> ]]> </programlisting> </para> </example> <para> Vedere anche <function>trim</function> and <function>rtrim</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/md5-file.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/md5-file.xml +++ phpdoc-it/reference/strings/functions/md5-file.xml <?xml version="1.0" encoding="iso-8859-1"?>    <refentry id="function.md5-file"> <refnamediv> <refname>md5_file</refname> <refpurpose>Calcola l'hash md5 del file dato</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>md5_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>raw_output</parameter></methodparam> </methodsynopsis> <para> Calcola l'hash md5 del file <parameter>filename</parameter> utilizzando l' <ulink url="&url.rfc;1321">RSA Data Security, Inc. MD5 Message-Digest Algorithm</ulink>, e lo restituisce. L'hash prodotto è un numero esadecimale di 32 caratteri. Se il secondo parametro <parameter>raw_output</parameter> è impostato a &true;, il valore md5 è restituito nel formato binario raw con una lunghezza di 16 caratteri. </para> <note> <simpara> Il parametro opzionale <parameter>raw_output</parameter> è stato aggiunto in PHP 5.0.0, e come default vale &false; </simpara> </note> <para> Questa funzione ha il medesimo scopo dell'utilità di linea di comando md5sum. </para> <para> Vedere anche <function>md5</function>, <function>crc32</function> e <function>sha1_file</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/md5.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/md5.xml +++ phpdoc-it/reference/strings/functions/md5.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.md5"> <refnamediv> <refname>md5</refname> <refpurpose>Calcola il valore md5 di una stringa</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>md5</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam choice='opt'><type>bool</type><parameter>raw_output</parameter></methodparam> </methodsynopsis> <para> Calcola il valore md5 della stringa <parameter>str</parameter> utilizzando il <ulink url="&url.rfc;1321">RSA Data Security, Inc. MD5 Message-Digest Algorithm</ulink>, e restituisce tale valore. L'hash prodotto è un numero esadecimale di 32 caratteri. Se il secondo parametro <parameter>raw_output</parameter> è impostato a &true;, il valore md5 è restituito nel formato binario raw con una lunghezza di 16 caratteri. </para> <note> <simpara> Il parametro opzionale <parameter>raw_output</parameter> è stato aggiunto in PHP 5.0.0, e come default vale &false; </simpara> </note> <para> <example> <title>Esempio di uso di <function>md5</function></title> <programlisting role="php"> <![CDATA[ <?php $str = 'apple'; if (md5($str) === '1f3870be274f6c49b3e31a0c6728957f') { echo "Would you like a green or red apple?"; exit; } ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>crc32</function>, <function>md5_file</function> e <function>sha1</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/metaphone.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/metaphone.xml +++ phpdoc-it/reference/strings/functions/metaphone.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.metaphone"> <refnamediv> <refname>metaphone</refname> <refpurpose>Calcola la chiave metaphone di una stringa</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>metaphone</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> Calcola la chiave metaphone di <parameter>str</parameter>. </para> <para> In modo simile a <function>soundex</function> la funzione crea la medesima chiave per parole con il medesimo suono. Questa funzione è più accurata che <function>soundex</function> poichè conosce le regole di base della pronuncia inglese. Le chiavi metaphone generate hanno lunghezza variabile. </para> <para> La chiave Metaphone è stata sviluppata da Lawrence Philips <lphilips at verity dot com>. Viene descritta in ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995]. </para> </refsect1> </refentry>