cvs: phpdoc-it /reference/strings/functions fprintf.xml get-html-translation-table.xml join.xml levenshtein.xml ltrim.xml md5-file.xml metaphone.xml
money-format.xml
| From: | Andrioli Darvin | Date: | Mon, 09 May 2005 12:32:47 +0000 |
| Subject: | cvs: phpdoc-it /reference/strings/functions fprintf.xml get-html-translation-table.xml join.xml levenshtein.xml ltrim.xml md5-file.xml metaphone.xml money-format.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-711@lists.php.net to get a copy of this message | ||
darvina Mon May 9 08:32:47 2005 EDT
Modified files:
/phpdoc-it/reference/strings/functions fprintf.xml
get-html-translation-table.xml
join.xml levenshtein.xml
ltrim.xml md5-file.xml
metaphone.xml
money-format.xml
Log:
Sync to En tree
http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/fprintf.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/fprintf.xml diff -u phpdoc-it/reference/strings/functions/fprintf.xml:1.2 phpdoc-it/reference/strings/functions/fprintf.xml:1.3 --- phpdoc-it/reference/strings/functions/fprintf.xml:1.2 Mon Aug 9 08:01:48 2004 +++ phpdoc-it/reference/strings/functions/fprintf.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <refentry id="function.fprintf"> <refnamediv> <refname>fprintf</refname> @@ -12,113 +12,17 @@ <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <simpara> La funzione scrive una stringa formattata in base al parametro <parameter>format</parameter> nello stream indicato dal parametro - <parameter>handle</parameter>. + <parameter>handle</parameter>. I valori per il parametro <parameter>format</parameter> + sono descritti nella documentazione della funzione <function>sprintf</function>. </simpara> <simpara> - La stringa di formato è composta da 0 o più direttive: - i caratteri ordinari (escluso il <literal>%</literal>) sono - copiati direttamente nello stream, mentre le <emphasis>specifiche - di conversione</emphasis>, scaricano il proprio parametro. - Queste note si applicano alle funzioni <function>fprintf</function>, - <function>sprintf</function> e <function>printf</function>. + Restituisce la lunghezza della stringa prodotta. </simpara> - <para> - Ciascun parametro di conversione consiste nel segno percento - (<literal>%</literal>), seguito da uno più dei seguenti elementi - nell'ordine si ha: - <orderedlist> - <listitem> - <simpara> - Un parametro opzionale per la specifica del <emphasis>riempimento</emphasis> - che indica quale carattere sarà utilizzato per completare la stringa risultante - in modo da raggiungere la dimensione richiesta. Questo può essere uno spazio oppure uno - <literal>0</literal> (il carattere zero). Per default si completa con - spazi. Un carattere di riempimento alternativo può essere indicato - anteponendo a questo l'apice singolo (<literal>'</literal>). - Vedere gli esempi seguenti. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro opzionale per la specifica dell'<emphasis>allineamento</emphasis> - che indica se la stringa risultante debba essere giustificata a destra o a sinistra. - Per default le stringhe sono giustificate a destra; il carattere - <literal>-</literal> forza la giustificazione a sinistra. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro numerico opzionale per la specifica della <emphasis>dimensione</emphasis> - che indica di quanti caratteri (come minimo) debba essere lunga la - stringa. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro opzionale per indicare la <emphasis>precisione</emphasis> per indicare - quante cifre decimali debbano essere visualizzate per i numeri in virgola mobile. - Questo parametro non influenza gli altri tipi di formati, solo il tipo - <type>float</type>. (Un'altra funzione utile per la formattazione dei numeri è - <function>number_format</function>.) - </simpara> - </listitem> - <listitem> - <para> - Una specifica di <emphasis>tipo</emphasis> che indica il tipo - di dati dell'argomento. I possibili tipi sono: - <simplelist> - <member> - <literal>%</literal> - il carattere percento. Nessun - argomento è richiesto - </member> - <member> - <literal>b</literal> - l'argomento è trattato come un - intero e sarà presentato come numero binario. - </member> - <member> - <literal>c</literal> - l'argomento è trattato come un - intero e sarà presentato come carattere ASCII - del valore corrispondente. - </member> - <member> - <literal>d</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero decimale con segno. - </member> - <member> - <literal>u</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero decimale senza segno. - </member> - <member> - <literal>f</literal> - l'argomento è trattato come un - <type>float</type>e sarà presentato come un numero in virgola mobile. - </member> - <member> - <literal>o</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero ottale. - </member> - <member> - <literal>s</literal> - l'argomento sarà trattato e presentato - come una stringa. - </member> - <member> - <literal>x</literal> - the argument is treated as an integer - and presented as a hexadecimal number (with lowercase - letters). - </member> - <member> - <literal>X</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero esadecimale (con le - lettere maiuscole). - </member> - </simplelist> - </para> - </listitem> - </orderedlist> - </para> <simpara> Vedere anche: <function>printf</function>, <function>sprintf</function>, @@ -131,26 +35,36 @@ <title>Esempi</title> <para> <example> - <title><function>sprintf</function>: interi completati con zero</title> + <title><function>fprintf</function>: interi completati con zero</title> <programlisting role="php"> <![CDATA[ <?php -$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day); +if (!($fp = fopen('date.txt', 'w'))) + return; + +fprintf($fp, "%04d-%02d-%02d", $year, $month, $day); +// Scrive la data in formato ISO nel file date.txt ?> ]]> </programlisting> </example> <example> - <title><function>sprintf</function>: formattazione della moneta</title> + <title><function>fprintf</function>: formattazione della moneta</title> <programlisting role="php"> <![CDATA[ <?php +if (!($fp = fopen('currency.txt', 'w'))) + return; + $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // echo $money will output "123.1"; -$formatted = sprintf("%01.2f", $money); -// echo $formatted will output "123.10" +$len = fprintf($fp, '%01.2f', $money); +// scrive "123.10" nel file currency.txt + +echo "wrote $len bytes to currency.txt"; +// utilizza il valore restituito da fprintf per stabilire quanti byte sono stati scritti ?> ]]> </programlisting> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/get-html-translation-table.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/get-html-translation-table.xml diff -u phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.1 phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.2 --- phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.1 Thu Jul 29 08:21:26 2004 +++ phpdoc-it/reference/strings/functions/get-html-translation-table.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.get-html-translation-table"> <refnamediv> @@ -14,7 +14,7 @@ <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>get_html_translation_table</methodname> - <methodparam><type>int</type><parameter>table</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>table</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> </methodsynopsis> <para> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/join.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/join.xml diff -u phpdoc-it/reference/strings/functions/join.xml:1.1 phpdoc-it/reference/strings/functions/join.xml:1.2 --- phpdoc-it/reference/strings/functions/join.xml:1.1 Mon Aug 2 08:03:58 2004 +++ phpdoc-it/reference/strings/functions/join.xml Mon May 9 08:32:47 2005 @@ -1,16 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.join"> <refnamediv> <refname>join</refname> - <refpurpose>Alias di <function>implode</function></refpurpose> + <refpurpose>&Alias; di <function>implode</function></refpurpose> </refnamediv> - <refsect1> - <title>Descrizione</title> - <para> - Questa funzione è un alias di <function>implode</function>. - </para> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>implode</function>. + </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/levenshtein.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/strings/functions/levenshtein.xml diff -u phpdoc-it/reference/strings/functions/levenshtein.xml:1.3 phpdoc-it/reference/strings/functions/levenshtein.xml:1.4 --- phpdoc-it/reference/strings/functions/levenshtein.xml:1.3 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/levenshtein.xml Mon May 9 08:32:47 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.12 --> <refentry id="function.levenshtein"> <refnamediv> - <refname>levenshtein</refname> + <refname>levenshtein</refname> <refpurpose> Calcola la distanza Levenshtein tra due stringhe </refpurpose> @@ -23,15 +23,13 @@ <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> + <methodparam><type>callback</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). + lungo del limite di 255 caratteri. </para> <para> La distanza Levenshtein è definita come il numero minimo di @@ -118,6 +116,68 @@ </para> --> <para> + <example> + <title>Esempio di uso di <function>levenshtein</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// input parola errata +$input = 'carrrot'; + +// matrice di parole con cui verificare +$words = array('apple','pineapple','banana','orange', + 'radish','carrot','pea','bean','potato'); + +// non ancora trovata la distanza più breve +$shortest = -1; + +// loop su tutte le parole per trovare la più simile +foreach ($words as $word) { + + // calcola la distanza tra la parola di input + // e la corrente + $lev = levenshtein($input, $word); + + // è la parola esatta? + if ($lev == 0) { + + // la più simile è questa + $closest = $word; + $shortest = 0; + + // esce dal loop, l'abbiamo trovata + break; + } + + // se la distanza è inferiore rispetto alla precendete più corta + // o non ne abbiamo ancora trovata una + if ($lev <= $shortest || $shortest < 0) { + // imposta la parola più simile e la distanza più breve + $closest = $word; + $shortest = $lev; + } +} + +echo "Input word: $input\n"; +if ($shortest == 0) { + echo "Exact match found: $closest\n"; +} else { + echo "Did you mean: $closest?\n"; +} + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Input word: carrrot +Did you mean: carrot? +]]> + </screen> + </example> + </para> + <para> Vedere anche <function>soundex</function>, <function>similar_text</function> e <function>metaphone</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/ltrim.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/strings/functions/ltrim.xml diff -u phpdoc-it/reference/strings/functions/ltrim.xml:1.4 phpdoc-it/reference/strings/functions/ltrim.xml:1.5 --- phpdoc-it/reference/strings/functions/ltrim.xml:1.4 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/ltrim.xml Mon May 9 08:32:47 2005 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.ltrim"> <refnamediv> <refname>ltrim</refname> <refpurpose> - Rimuove gli spazi dall'inizio di una stringa + Rimuove gli spazi (o altri caratteri) dall'inizio di una stringa </refpurpose> </refnamediv> <refsect1> @@ -73,7 +73,7 @@ </para> <example> <title>Esempio di uso di <function>ltrim</function></title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php @@ -88,7 +88,7 @@ ?> ]]> - </programlisting> + </programlisting> </example> <para> Vedere anche <function>trim</function> and <function>rtrim</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/md5-file.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/md5-file.xml diff -u phpdoc-it/reference/strings/functions/md5-file.xml:1.1 phpdoc-it/reference/strings/functions/md5-file.xml:1.2 --- phpdoc-it/reference/strings/functions/md5-file.xml:1.1 Mon Aug 2 08:03:59 2004 +++ phpdoc-it/reference/strings/functions/md5-file.xml Mon May 9 08:32:47 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- $Revision: 1.1 $ --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.md5-file"> <refnamediv> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/metaphone.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/metaphone.xml diff -u phpdoc-it/reference/strings/functions/metaphone.xml:1.2 phpdoc-it/reference/strings/functions/metaphone.xml:1.3 --- phpdoc-it/reference/strings/functions/metaphone.xml:1.2 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/metaphone.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.metaphone"> <refnamediv> @@ -11,6 +11,7 @@ <methodsynopsis> <type>string</type><methodname>metaphone</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>phones</parameter></methodparam> </methodsynopsis> <para> Calcola la chiave metaphone di <parameter>str</parameter>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/money-format.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/money-format.xml diff -u phpdoc-it/reference/strings/functions/money-format.xml:1.2 phpdoc-it/reference/strings/functions/money-format.xml:1.3 --- phpdoc-it/reference/strings/functions/money-format.xml:1.2 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/money-format.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> <refentry id="function.money-format"> <refnamediv> <refname>money_format</refname>
http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/fprintf.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/fprintf.xml diff -u phpdoc-it/reference/strings/functions/fprintf.xml:1.2 phpdoc-it/reference/strings/functions/fprintf.xml:1.3 --- phpdoc-it/reference/strings/functions/fprintf.xml:1.2 Mon Aug 9 08:01:48 2004 +++ phpdoc-it/reference/strings/functions/fprintf.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <refentry id="function.fprintf"> <refnamediv> <refname>fprintf</refname> @@ -12,113 +12,17 @@ <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <simpara> La funzione scrive una stringa formattata in base al parametro <parameter>format</parameter> nello stream indicato dal parametro - <parameter>handle</parameter>. + <parameter>handle</parameter>. I valori per il parametro <parameter>format</parameter> + sono descritti nella documentazione della funzione <function>sprintf</function>. </simpara> <simpara> - La stringa di formato è composta da 0 o più direttive: - i caratteri ordinari (escluso il <literal>%</literal>) sono - copiati direttamente nello stream, mentre le <emphasis>specifiche - di conversione</emphasis>, scaricano il proprio parametro. - Queste note si applicano alle funzioni <function>fprintf</function>, - <function>sprintf</function> e <function>printf</function>. + Restituisce la lunghezza della stringa prodotta. </simpara> - <para> - Ciascun parametro di conversione consiste nel segno percento - (<literal>%</literal>), seguito da uno più dei seguenti elementi - nell'ordine si ha: - <orderedlist> - <listitem> - <simpara> - Un parametro opzionale per la specifica del <emphasis>riempimento</emphasis> - che indica quale carattere sarà utilizzato per completare la stringa risultante - in modo da raggiungere la dimensione richiesta. Questo può essere uno spazio oppure uno - <literal>0</literal> (il carattere zero). Per default si completa con - spazi. Un carattere di riempimento alternativo può essere indicato - anteponendo a questo l'apice singolo (<literal>'</literal>). - Vedere gli esempi seguenti. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro opzionale per la specifica dell'<emphasis>allineamento</emphasis> - che indica se la stringa risultante debba essere giustificata a destra o a sinistra. - Per default le stringhe sono giustificate a destra; il carattere - <literal>-</literal> forza la giustificazione a sinistra. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro numerico opzionale per la specifica della <emphasis>dimensione</emphasis> - che indica di quanti caratteri (come minimo) debba essere lunga la - stringa. - </simpara> - </listitem> - <listitem> - <simpara> - Un parametro opzionale per indicare la <emphasis>precisione</emphasis> per indicare - quante cifre decimali debbano essere visualizzate per i numeri in virgola mobile. - Questo parametro non influenza gli altri tipi di formati, solo il tipo - <type>float</type>. (Un'altra funzione utile per la formattazione dei numeri è - <function>number_format</function>.) - </simpara> - </listitem> - <listitem> - <para> - Una specifica di <emphasis>tipo</emphasis> che indica il tipo - di dati dell'argomento. I possibili tipi sono: - <simplelist> - <member> - <literal>%</literal> - il carattere percento. Nessun - argomento è richiesto - </member> - <member> - <literal>b</literal> - l'argomento è trattato come un - intero e sarà presentato come numero binario. - </member> - <member> - <literal>c</literal> - l'argomento è trattato come un - intero e sarà presentato come carattere ASCII - del valore corrispondente. - </member> - <member> - <literal>d</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero decimale con segno. - </member> - <member> - <literal>u</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero decimale senza segno. - </member> - <member> - <literal>f</literal> - l'argomento è trattato come un - <type>float</type>e sarà presentato come un numero in virgola mobile. - </member> - <member> - <literal>o</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero ottale. - </member> - <member> - <literal>s</literal> - l'argomento sarà trattato e presentato - come una stringa. - </member> - <member> - <literal>x</literal> - the argument is treated as an integer - and presented as a hexadecimal number (with lowercase - letters). - </member> - <member> - <literal>X</literal> - l'argomento è trattato come un - intero e sarà presentato come un numero esadecimale (con le - lettere maiuscole). - </member> - </simplelist> - </para> - </listitem> - </orderedlist> - </para> <simpara> Vedere anche: <function>printf</function>, <function>sprintf</function>, @@ -131,26 +35,36 @@ <title>Esempi</title> <para> <example> - <title><function>sprintf</function>: interi completati con zero</title> + <title><function>fprintf</function>: interi completati con zero</title> <programlisting role="php"> <![CDATA[ <?php -$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day); +if (!($fp = fopen('date.txt', 'w'))) + return; + +fprintf($fp, "%04d-%02d-%02d", $year, $month, $day); +// Scrive la data in formato ISO nel file date.txt ?> ]]> </programlisting> </example> <example> - <title><function>sprintf</function>: formattazione della moneta</title> + <title><function>fprintf</function>: formattazione della moneta</title> <programlisting role="php"> <![CDATA[ <?php +if (!($fp = fopen('currency.txt', 'w'))) + return; + $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // echo $money will output "123.1"; -$formatted = sprintf("%01.2f", $money); -// echo $formatted will output "123.10" +$len = fprintf($fp, '%01.2f', $money); +// scrive "123.10" nel file currency.txt + +echo "wrote $len bytes to currency.txt"; +// utilizza il valore restituito da fprintf per stabilire quanti byte sono stati scritti ?> ]]> </programlisting> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/get-html-translation-table.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/get-html-translation-table.xml diff -u phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.1 phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.2 --- phpdoc-it/reference/strings/functions/get-html-translation-table.xml:1.1 Thu Jul 29 08:21:26 2004 +++ phpdoc-it/reference/strings/functions/get-html-translation-table.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.get-html-translation-table"> <refnamediv> @@ -14,7 +14,7 @@ <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>get_html_translation_table</methodname> - <methodparam><type>int</type><parameter>table</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>table</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> </methodsynopsis> <para> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/join.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/join.xml diff -u phpdoc-it/reference/strings/functions/join.xml:1.1 phpdoc-it/reference/strings/functions/join.xml:1.2 --- phpdoc-it/reference/strings/functions/join.xml:1.1 Mon Aug 2 08:03:58 2004 +++ phpdoc-it/reference/strings/functions/join.xml Mon May 9 08:32:47 2005 @@ -1,16 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.join"> <refnamediv> <refname>join</refname> - <refpurpose>Alias di <function>implode</function></refpurpose> + <refpurpose>&Alias; di <function>implode</function></refpurpose> </refnamediv> - <refsect1> - <title>Descrizione</title> - <para> - Questa funzione è un alias di <function>implode</function>. - </para> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>implode</function>. + </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/levenshtein.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/strings/functions/levenshtein.xml diff -u phpdoc-it/reference/strings/functions/levenshtein.xml:1.3 phpdoc-it/reference/strings/functions/levenshtein.xml:1.4 --- phpdoc-it/reference/strings/functions/levenshtein.xml:1.3 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/levenshtein.xml Mon May 9 08:32:47 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.12 --> <refentry id="function.levenshtein"> <refnamediv> - <refname>levenshtein</refname> + <refname>levenshtein</refname> <refpurpose> Calcola la distanza Levenshtein tra due stringhe </refpurpose> @@ -23,15 +23,13 @@ <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> + <methodparam><type>callback</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). + lungo del limite di 255 caratteri. </para> <para> La distanza Levenshtein è definita come il numero minimo di @@ -118,6 +116,68 @@ </para> --> <para> + <example> + <title>Esempio di uso di <function>levenshtein</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// input parola errata +$input = 'carrrot'; + +// matrice di parole con cui verificare +$words = array('apple','pineapple','banana','orange', + 'radish','carrot','pea','bean','potato'); + +// non ancora trovata la distanza più breve +$shortest = -1; + +// loop su tutte le parole per trovare la più simile +foreach ($words as $word) { + + // calcola la distanza tra la parola di input + // e la corrente + $lev = levenshtein($input, $word); + + // è la parola esatta? + if ($lev == 0) { + + // la più simile è questa + $closest = $word; + $shortest = 0; + + // esce dal loop, l'abbiamo trovata + break; + } + + // se la distanza è inferiore rispetto alla precendete più corta + // o non ne abbiamo ancora trovata una + if ($lev <= $shortest || $shortest < 0) { + // imposta la parola più simile e la distanza più breve + $closest = $word; + $shortest = $lev; + } +} + +echo "Input word: $input\n"; +if ($shortest == 0) { + echo "Exact match found: $closest\n"; +} else { + echo "Did you mean: $closest?\n"; +} + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Input word: carrrot +Did you mean: carrot? +]]> + </screen> + </example> + </para> + <para> Vedere anche <function>soundex</function>, <function>similar_text</function> e <function>metaphone</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/ltrim.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/strings/functions/ltrim.xml diff -u phpdoc-it/reference/strings/functions/ltrim.xml:1.4 phpdoc-it/reference/strings/functions/ltrim.xml:1.5 --- phpdoc-it/reference/strings/functions/ltrim.xml:1.4 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/ltrim.xml Mon May 9 08:32:47 2005 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.ltrim"> <refnamediv> <refname>ltrim</refname> <refpurpose> - Rimuove gli spazi dall'inizio di una stringa + Rimuove gli spazi (o altri caratteri) dall'inizio di una stringa </refpurpose> </refnamediv> <refsect1> @@ -73,7 +73,7 @@ </para> <example> <title>Esempio di uso di <function>ltrim</function></title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php @@ -88,7 +88,7 @@ ?> ]]> - </programlisting> + </programlisting> </example> <para> Vedere anche <function>trim</function> and <function>rtrim</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/md5-file.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/strings/functions/md5-file.xml diff -u phpdoc-it/reference/strings/functions/md5-file.xml:1.1 phpdoc-it/reference/strings/functions/md5-file.xml:1.2 --- phpdoc-it/reference/strings/functions/md5-file.xml:1.1 Mon Aug 2 08:03:59 2004 +++ phpdoc-it/reference/strings/functions/md5-file.xml Mon May 9 08:32:47 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- $Revision: 1.1 $ --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.md5-file"> <refnamediv> http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/metaphone.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/metaphone.xml diff -u phpdoc-it/reference/strings/functions/metaphone.xml:1.2 phpdoc-it/reference/strings/functions/metaphone.xml:1.3 --- phpdoc-it/reference/strings/functions/metaphone.xml:1.2 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/metaphone.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.metaphone"> <refnamediv> @@ -11,6 +11,7 @@ <methodsynopsis> <type>string</type><methodname>metaphone</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>phones</parameter></methodparam> </methodsynopsis> <para> Calcola la chiave metaphone di <parameter>str</parameter>. http://cvs.php.net/diff.php/phpdoc-it/reference/strings/functions/money-format.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/strings/functions/money-format.xml diff -u phpdoc-it/reference/strings/functions/money-format.xml:1.2 phpdoc-it/reference/strings/functions/money-format.xml:1.3 --- phpdoc-it/reference/strings/functions/money-format.xml:1.2 Thu Sep 16 08:20:38 2004 +++ phpdoc-it/reference/strings/functions/money-format.xml Mon May 9 08:32:47 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> <refentry id="function.money-format"> <refnamediv> <refname>money_format</refname>