svn: /phpdoc/it/trunk/language/ functions.xml
| From: | Davide Pastore | Date: | Sat, 12 Dec 2020 15:30:33 +0000 |
| Subject: | svn: /phpdoc/it/trunk/language/ functions.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-2560@lists.php.net to get a copy of this message | ||
pastore Sat, 12 Dec 2020 15:30:33 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=352026
Log:
Sync with EN and fix build
Changed paths:
U phpdoc/it/trunk/language/functions.xml
Modified: phpdoc/it/trunk/language/functions.xml
===================================================================
--- phpdoc/it/trunk/language/functions.xml 2020-12-12 15:03:30 UTC (rev 352025)
+++ phpdoc/it/trunk/language/functions.xml 2020-12-12 15:30:33 UTC (rev 352026)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351365 Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 351933 Maintainer: pastore Status: ready -->
<!-- CREDITS: spisto -->
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
<title>Funzioni</title>
@@ -202,6 +202,53 @@
</programlisting>
</example>
</para>
+ <para>
+ A partire da PHP 8.0.0, l'elenco degli argomenti della funzione può includere una virgola
finale, che
+ verrà ignorata. Ciò è particolarmente utile nei casi in cui l'elenco di argomenti è
+ lungo o contiene nomi di variabili lunghi, rendendo conveniente elencare gli argomenti
verticalmente.
+ </para>
+ <example>
+ <title>Elenco degli Argomenti della Funzione con Virgola finale</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function takes_many_args(
+ $first_arg,
+ $second_arg,
+ $a_very_long_argument_name,
+ $arg_with_default = 5,
+ $again = 'a default string', // Questa virgola finale non era consentita prima della
8.0.0.
+)
+{
+ // ...
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ <para>
+ A partire da PHP 8.0.0, passare argomenti obbligatori dopo argomenti opzionali
+ è deprecato. Questo può essere generalmente risolto eliminando il valore predefinito.
+ Un'eccezione a questa regola sono gli argomenti nella forma
+ <code>Type $param = null</code>, dove il default &null; rende il tipo
implicitamente
+ annullabile. Questo utilizzo rimane consentito, sebbene si consiglia di utilizzare invece
+ un tipo nullable esplicito.
+ </para>
+ <example>
+ <title>Passaggio di argomenti facoltativi dopo argomenti obbligatori</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function foo($a = [], $b) {} // Prima
+function foo($a, $b) {} // Dopo
+
+function bar(A $a = null, $b) {} // Ancora consentito
+function bar(?A $a, $b) {} // Consigliato
+?>
+]]>
+ </programlisting>
+ </example>
+
<sect2 xml:id="functions.arguments.by-reference">
<title>Passare argomenti per riferimento</title>
@@ -533,6 +580,111 @@
</sect3>
</sect2>
+
+ <sect2 xml:id="functions.named-arguments">
+ <title>Argomenti Nominali</title>
+
+ <para>
+ PHP 8.0.0 ha introdotto argomenti nominali come estensione dei parametri
+ posizionali esistenti. Gli argomenti nominali consentono di passare argomenti ad una
+ funzione in base al nome del parametro, piuttosto che alla posizione del parametro.
+ Ciò rende il significato dell'argomento auto-documentante, rende gli
+ argomenti indipendenti dall'ordine e consente di saltare arbitrariamente i valori
predefiniti.
+ </para>
+
+ <para>
+ Gli argomenti nominali vengono passati anteponendo al valore il nome del parametro
+ seguito da due punti. È consentito l'utilizzo di parole chiave riservate come nomi di
parametri.
+ Il nome del parametro deve essere un identificatore, non è consentito
+ specificarlo dinamicamente.
+ </para>
+
+ <example>
+ <title>Sintassi dell'argomento denominato</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+myFunction(paramName: $value);
+array_foobar(array: $value);
+
+// NON supportato.
+function_name($variableStoringParamName: $value);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <example>
+ <title>Argomenti posizionali contro argomenti nominali</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+// Utilizzo di argomenti posizionali:
+array_fill(0, 100, 50);
+
+// Utilizzo di argomenti nominali:
+array_fill(start_index: 0, num: 100, value: 50);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ L'ordine in cui vengono passati gli argomenti nominali non ha importanza.
+ </para>
+
+ <example>
+ <title>Stesso esempio di sopra con un diverso ordine dei parametri</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+array_fill(value: 50, num: 100, start_index: 0);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ Gli argomenti nominali possono essere combinati con argomenti posizionali. In questo caso,
+ gli argomenti nominali devono venire dopo gli argomenti posizionali.
+ È anche possibile specificare solo alcuni degli argomenti opzionali di una
+ funzione, indipendentemente dal loro ordine.
+ </para>
+
+ <example>
+ <title>Combinazione di argomenti nominali con argomenti posizionali</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+htmlspecialchars($string, double_encode: false);
+// Uguale a
+htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ Il passaggio multiplo dello stesso parametro genera un'eccezione Error.
+ </para>
+
+ <example>
+ <title>Eccezione Error durante il passaggio multiplo dello stesso
parametro</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+function foo($param) { ... }
+
+foo(param: 1, param: 2);
+// Error: Named parameter $param overwrites previous argument
+foo(1, param: 2);
+// Error: Named parameter $param overwrites previous argument
+?>
+]]>
+ </programlisting>
+ </example>
+
+ </sect2>
</sect1>
<sect1 xml:id="functions.returning-values">
@@ -886,7 +1038,7 @@
<simpara>
Le chiusure possono anche ereditare le variabili dal contesto del genitore. Ognuna di queste
variabili deve essere passata al costrutto del linguaggio <literal>use</literal>.
- Da PHP 7.1, queste variabili non devono includere &link.superglobals;,
+ A partire da PHP 7.1, queste variabili non devono includere &link.superglobals;,
<varname>$this</varname>, o variabili con lo stesso nome di un parametro.
</simpara>
@@ -950,6 +1102,10 @@
</screen>
</example>
+ <para>
+ A partire da PHP 8.0.0, l'elenco delle variabili ereditate dallo scope può includere una
virgola
+ finale, che verrà ignorata.
+ </para>
<simpara>
Ereditare le variabili dall'ambito genitore <emphasis>non</emphasis>
è la stessa cosa che usare variabili globali.