cvs: phpdoc-it /language basic-syntax.xml constants.xml control-structures.xml oop.xml
| From: | Andrioli Darvin | Date: | Tue, 19 Jul 2005 12:29:11 +0000 |
| Subject: | cvs: phpdoc-it /language basic-syntax.xml constants.xml control-structures.xml oop.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-773@lists.php.net to get a copy of this message | ||
darvina Tue Jul 19 08:29:11 2005 EDT
Modified files:
/phpdoc-it/language basic-syntax.xml constants.xml
control-structures.xml oop.xml
Log:
Sync to En tree
http://cvs.php.net/diff.php/phpdoc-it/language/basic-syntax.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc-it/language/basic-syntax.xml diff -u phpdoc-it/language/basic-syntax.xml:1.11 phpdoc-it/language/basic-syntax.xml:1.12 --- phpdoc-it/language/basic-syntax.xml:1.11 Wed Jun 22 07:54:54 2005 +++ phpdoc-it/language/basic-syntax.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.44 Maintainer: perugini Status: ready --> +<!-- EN-Revision: 1.45 Maintainer: perugini Status: ready --> <chapter id="language.basic-syntax"> <title>Sintassi Fondamentale</title> @@ -135,7 +135,7 @@ <title>Separazione delle istruzioni</title> <para> - Come in C od in Perl, il PHP richiede che le istruzioni siano separate + Come in C od in Perl, il PHP richiede che le istruzioni siano chiuse dal punto e virgola al termine di ogni istruzione. I tag di chiusura di un blocco di codice PHP implicano in automatico il punto e virgola; non occorre, pertanto, inserire il punto e virgola per chiudere l'ultima riga http://cvs.php.net/diff.php/phpdoc-it/language/constants.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc-it/language/constants.xml diff -u phpdoc-it/language/constants.xml:1.11 phpdoc-it/language/constants.xml:1.12 --- phpdoc-it/language/constants.xml:1.11 Fri Jul 11 15:54:46 2003 +++ phpdoc-it/language/constants.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.33 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.40 Maintainer: cortesi Status: ready --> <chapter id="language.constants"> <title>Costanti</title> @@ -17,10 +17,30 @@ da un numero qualsiasi di caratteri alfanumerici o underscore. L'espressione regolare che esprime questa convenzione è: <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - - <!-- TODO: Example of valid & invalid constant names --> </para> - + <para> + <example> + <title>Nomi di costanti validi ed errati</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Nomi validi +define("FOO", "something"); +define("FOO2", "something else"); +define("FOO_BAR", "something more") + +// Nomi di costante errati +define("2FOO", "something"); + +// Nomi validi, ma da evitare: +// un domani potrebbero essere utilizzati dal PHP per fornire costanti magiche +// e quindi si avrebbero problemi nello script +define("__FOO__", "something"); +?> +]]> + </programlisting> + </example> + </para> <note> <simpara> In questo contesto una lettera è a-z, A-Z e i caratteri ASCII @@ -127,15 +147,16 @@ </sect1> <sect1 id="language.constants.predefined"> - <title>Costanti predefinite</title> + <title>Costanti magiche</title> <simpara> - Il PHP mette a disposizione ad ogni script diverse costanti predefinite. + Il PHP mette a disposizione ad ogni script diverse <link + linkend="reserved.constants">costanti predefinite</link> disponibili a tutti gli script. Alcune di queste, tuttavia, sono create dai vari moduli, e, pertanto, saranno disponibili solo quando questi moduli sono caricati, sia dinamicamente sia staticamente. </simpara> <para> - Esistono quattro costanti magiche il cui valore cambia in base + Esistono cinque costanti magiche il cui valore cambia in base al contesto in cui sono utilizzate. Ad esempio, il valore di <constant>__LINE__</constant> dipende da quale linea si trova nel momento in cui è richiamata. Queste costanti speciali sono 'case-insensitive' e sono: @@ -160,25 +181,34 @@ <row> <entry><constant>__FILE__</constant></entry> <entry> - Il nome e percorso assoluto del file. + Il nome e percorso assoluto del file. Se viene utilizzata + all'interno di un'include, la costante restituisce il nome del file incluso. + Dal PHP 4.0.2, <constant>__FILE__</constant> contiene sempre + il percorso assoluto del file, mentre nelle versioni precedenti, + in base alle circostanze, poteva contenere il percorso relativo. </entry> </row> <row> <entry><constant>__FUNCTION__</constant></entry> <entry> - Nome della funzione. (Aggiunta nel PHP 4.3.0.) + Nome della funzione. (Aggiunta nel PHP 4.3.0.) Dal PHP 5 questa costante + restituisce il nome della funzione così come è stato dichiarato (rispettando le lettere maiuscole). + In PHP 4 è sempre minuscolo. </entry> </row> <row> <entry><constant>__CLASS__</constant></entry> <entry> - Nome della classe. (Aggiunta nel PHP 4.3.0.) + Nome della classe. (Aggiunta nel PHP 4.3.0.). Dal PHP 5 questa costante + restituisce il nome della classe così come è stato dichiarato (rispettando le lettere maiuscole). + In PHP 4 è sempre minuscolo. </entry> </row> <row> <entry><constant>__METHOD__</constant></entry> <entry> - Nome del metodo della classe (Aggiunta nel PHP 5.0.0.) + Nome del metodo della classe. (Aggiunta nel PHP 5.0.0.). Questa costante + restituisce il nome del metodo così come è stato dichiarato (rispettando le lettere maiuscole). </entry> </row> </tbody> @@ -186,11 +216,13 @@ </table> </para> - <simpara> - La lista di tutte le costanti predefinite è presente nella sezione - <link linkend="reserved.constants">reserved predefined constants</link>. - </simpara> - + <para> + Vedere anche + <function>get_class</function>, + <function>get_object_vars</function>, + <function>file_exists</function>&listendand; + <function>function_exists</function>. + </para> </sect1> </chapter> http://cvs.php.net/diff.php/phpdoc-it/language/control-structures.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-it/language/control-structures.xml diff -u phpdoc-it/language/control-structures.xml:1.14 phpdoc-it/language/control-structures.xml:1.15 --- phpdoc-it/language/control-structures.xml:1.14 Fri Jun 17 08:17:20 2005 +++ phpdoc-it/language/control-structures.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.119 Maintainer: spisto Status: ready --> +<!-- EN-Revision: 1.123 Maintainer: spisto Status: ready --> <chapter id="language.control-structures"> <title>Strutture di controllo</title> @@ -1106,7 +1106,7 @@ if ($dump) { $temp = $profile; unset($profile); - return($temp); + return $temp; } $profile[] = microtime(); @@ -1184,9 +1184,21 @@ Notate che poichè <function>return</function> è un costrutto di linguaggio e non una funzione, le parentesi che circondano i suoi argomenti sono <emphasis>soltanto</emphasis> richieste se l'argomento - contiene un'espressione. E' comune non utilizzarle quando si ritorna una variabile. + contiene un'espressione. E' comune non utilizzarle quando si ritorna una variabile, + ed inoltre il PHP ha meno lavoro da svolgere + in questo caso. </simpara> </note> + <note> + <simpara> + Non si dovrebbe <emphasis>mai</emphasis> utilizzare le parantesi intorno alle variabili restituite + quando sono restituite per riferimento, poichè non funzionerebbe. Per riferimento + si possono restituire solo variabili, non il risultato di un'istruzione. + Se si utilizza <literal>return ($a);</literal> non si restituisce una variabile, + ma il risultato dell'espressione <literal>($a)</literal> + (che, ovviamente, è il valore di <varname>$a</varname>). + </simpara> + </note> </para> </sect1> http://cvs.php.net/diff.php/phpdoc-it/language/oop.xml?r1=1.16&r2=1.17&ty=u Index: phpdoc-it/language/oop.xml diff -u phpdoc-it/language/oop.xml:1.16 phpdoc-it/language/oop.xml:1.17 --- phpdoc-it/language/oop.xml:1.16 Fri Jun 3 07:55:52 2005 +++ phpdoc-it/language/oop.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.62 Maintainer: alan_dangelo Status: ready --> +<!-- EN-Revision: 1.63 Maintainer: alan_dangelo Status: ready --> <chapter id="language.oop"> <title>Classi e Oggetti (PHP 4)</title>
http://cvs.php.net/diff.php/phpdoc-it/language/basic-syntax.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc-it/language/basic-syntax.xml diff -u phpdoc-it/language/basic-syntax.xml:1.11 phpdoc-it/language/basic-syntax.xml:1.12 --- phpdoc-it/language/basic-syntax.xml:1.11 Wed Jun 22 07:54:54 2005 +++ phpdoc-it/language/basic-syntax.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.44 Maintainer: perugini Status: ready --> +<!-- EN-Revision: 1.45 Maintainer: perugini Status: ready --> <chapter id="language.basic-syntax"> <title>Sintassi Fondamentale</title> @@ -135,7 +135,7 @@ <title>Separazione delle istruzioni</title> <para> - Come in C od in Perl, il PHP richiede che le istruzioni siano separate + Come in C od in Perl, il PHP richiede che le istruzioni siano chiuse dal punto e virgola al termine di ogni istruzione. I tag di chiusura di un blocco di codice PHP implicano in automatico il punto e virgola; non occorre, pertanto, inserire il punto e virgola per chiudere l'ultima riga http://cvs.php.net/diff.php/phpdoc-it/language/constants.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc-it/language/constants.xml diff -u phpdoc-it/language/constants.xml:1.11 phpdoc-it/language/constants.xml:1.12 --- phpdoc-it/language/constants.xml:1.11 Fri Jul 11 15:54:46 2003 +++ phpdoc-it/language/constants.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.33 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.40 Maintainer: cortesi Status: ready --> <chapter id="language.constants"> <title>Costanti</title> @@ -17,10 +17,30 @@ da un numero qualsiasi di caratteri alfanumerici o underscore. L'espressione regolare che esprime questa convenzione è: <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - - <!-- TODO: Example of valid & invalid constant names --> </para> - + <para> + <example> + <title>Nomi di costanti validi ed errati</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Nomi validi +define("FOO", "something"); +define("FOO2", "something else"); +define("FOO_BAR", "something more") + +// Nomi di costante errati +define("2FOO", "something"); + +// Nomi validi, ma da evitare: +// un domani potrebbero essere utilizzati dal PHP per fornire costanti magiche +// e quindi si avrebbero problemi nello script +define("__FOO__", "something"); +?> +]]> + </programlisting> + </example> + </para> <note> <simpara> In questo contesto una lettera è a-z, A-Z e i caratteri ASCII @@ -127,15 +147,16 @@ </sect1> <sect1 id="language.constants.predefined"> - <title>Costanti predefinite</title> + <title>Costanti magiche</title> <simpara> - Il PHP mette a disposizione ad ogni script diverse costanti predefinite. + Il PHP mette a disposizione ad ogni script diverse <link + linkend="reserved.constants">costanti predefinite</link> disponibili a tutti gli script. Alcune di queste, tuttavia, sono create dai vari moduli, e, pertanto, saranno disponibili solo quando questi moduli sono caricati, sia dinamicamente sia staticamente. </simpara> <para> - Esistono quattro costanti magiche il cui valore cambia in base + Esistono cinque costanti magiche il cui valore cambia in base al contesto in cui sono utilizzate. Ad esempio, il valore di <constant>__LINE__</constant> dipende da quale linea si trova nel momento in cui è richiamata. Queste costanti speciali sono 'case-insensitive' e sono: @@ -160,25 +181,34 @@ <row> <entry><constant>__FILE__</constant></entry> <entry> - Il nome e percorso assoluto del file. + Il nome e percorso assoluto del file. Se viene utilizzata + all'interno di un'include, la costante restituisce il nome del file incluso. + Dal PHP 4.0.2, <constant>__FILE__</constant> contiene sempre + il percorso assoluto del file, mentre nelle versioni precedenti, + in base alle circostanze, poteva contenere il percorso relativo. </entry> </row> <row> <entry><constant>__FUNCTION__</constant></entry> <entry> - Nome della funzione. (Aggiunta nel PHP 4.3.0.) + Nome della funzione. (Aggiunta nel PHP 4.3.0.) Dal PHP 5 questa costante + restituisce il nome della funzione così come è stato dichiarato (rispettando le lettere maiuscole). + In PHP 4 è sempre minuscolo. </entry> </row> <row> <entry><constant>__CLASS__</constant></entry> <entry> - Nome della classe. (Aggiunta nel PHP 4.3.0.) + Nome della classe. (Aggiunta nel PHP 4.3.0.). Dal PHP 5 questa costante + restituisce il nome della classe così come è stato dichiarato (rispettando le lettere maiuscole). + In PHP 4 è sempre minuscolo. </entry> </row> <row> <entry><constant>__METHOD__</constant></entry> <entry> - Nome del metodo della classe (Aggiunta nel PHP 5.0.0.) + Nome del metodo della classe. (Aggiunta nel PHP 5.0.0.). Questa costante + restituisce il nome del metodo così come è stato dichiarato (rispettando le lettere maiuscole). </entry> </row> </tbody> @@ -186,11 +216,13 @@ </table> </para> - <simpara> - La lista di tutte le costanti predefinite è presente nella sezione - <link linkend="reserved.constants">reserved predefined constants</link>. - </simpara> - + <para> + Vedere anche + <function>get_class</function>, + <function>get_object_vars</function>, + <function>file_exists</function>&listendand; + <function>function_exists</function>. + </para> </sect1> </chapter> http://cvs.php.net/diff.php/phpdoc-it/language/control-structures.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-it/language/control-structures.xml diff -u phpdoc-it/language/control-structures.xml:1.14 phpdoc-it/language/control-structures.xml:1.15 --- phpdoc-it/language/control-structures.xml:1.14 Fri Jun 17 08:17:20 2005 +++ phpdoc-it/language/control-structures.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.119 Maintainer: spisto Status: ready --> +<!-- EN-Revision: 1.123 Maintainer: spisto Status: ready --> <chapter id="language.control-structures"> <title>Strutture di controllo</title> @@ -1106,7 +1106,7 @@ if ($dump) { $temp = $profile; unset($profile); - return($temp); + return $temp; } $profile[] = microtime(); @@ -1184,9 +1184,21 @@ Notate che poichè <function>return</function> è un costrutto di linguaggio e non una funzione, le parentesi che circondano i suoi argomenti sono <emphasis>soltanto</emphasis> richieste se l'argomento - contiene un'espressione. E' comune non utilizzarle quando si ritorna una variabile. + contiene un'espressione. E' comune non utilizzarle quando si ritorna una variabile, + ed inoltre il PHP ha meno lavoro da svolgere + in questo caso. </simpara> </note> + <note> + <simpara> + Non si dovrebbe <emphasis>mai</emphasis> utilizzare le parantesi intorno alle variabili restituite + quando sono restituite per riferimento, poichè non funzionerebbe. Per riferimento + si possono restituire solo variabili, non il risultato di un'istruzione. + Se si utilizza <literal>return ($a);</literal> non si restituisce una variabile, + ma il risultato dell'espressione <literal>($a)</literal> + (che, ovviamente, è il valore di <varname>$a</varname>). + </simpara> + </note> </para> </sect1> http://cvs.php.net/diff.php/phpdoc-it/language/oop.xml?r1=1.16&r2=1.17&ty=u Index: phpdoc-it/language/oop.xml diff -u phpdoc-it/language/oop.xml:1.16 phpdoc-it/language/oop.xml:1.17 --- phpdoc-it/language/oop.xml:1.16 Fri Jun 3 07:55:52 2005 +++ phpdoc-it/language/oop.xml Tue Jul 19 08:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.62 Maintainer: alan_dangelo Status: ready --> +<!-- EN-Revision: 1.63 Maintainer: alan_dangelo Status: ready --> <chapter id="language.oop"> <title>Classi e Oggetti (PHP 4)</title>