diff options
| author | Antonio Giovanni Colombo <azc100@gmail.com> | 2023-12-26 18:24:07 +0100 |
|---|---|---|
| committer | Antonio Giovanni Colombo <azc100@gmail.com> | 2023-12-26 18:24:07 +0100 |
| commit | d416aa83d6de3931f5a512f4c06f131758214c40 (patch) | |
| tree | 24f7bff3be06ad3ff97f9cc544109a92c9cb6a45 | |
| parent | 92f32a62595bc534a112ed408ba4e2c2dcd6b02d (diff) | |
| download | gawk-d416aa83d6de3931f5a512f4c06f131758214c40.tar.gz | |
Clarification about API + other minor stuff
| -rwxr-xr-x | doc/it/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/it/gawk.texi | 130 |
2 files changed, 46 insertions, 88 deletions
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog index 1cd1420..25fe7f6 100755 --- a/doc/it/ChangeLog +++ b/doc/it/ChangeLog @@ -1,3 +1,7 @@ +2023-12-26 Antonio Giovanni Colombo <azc100@gmail.com> + + * gawk.texi: Updated. + 2023-12-04 Antonio Giovanni Colombo <azc100@gmail.com> * gawk.texi: Updated. diff --git a/doc/it/gawk.texi b/doc/it/gawk.texi index 66abc9c..c9e5ad9 100644 --- a/doc/it/gawk.texi +++ b/doc/it/gawk.texi @@ -84,12 +84,7 @@ @set SECTIONS sezioni @set SUBSECTION sottosezione @set SUBSECTIONS sottosezioni -@ifclear SMALLPRINT @set DARKCORNER @inmargin{@image{lflashlight,1cm}, @image{rflashlight,1cm}} -@end ifclear -@ifset SMALLPRINT -@set DARKCORNER @inmargin{@image{lflashlight,0.7cm}, @image{rflashlight,0.7cm}} -@end ifset @set COMMONEXT (e.c.) @set PAGE pagina @end iftex @@ -480,26 +475,12 @@ URL: @uref{http://www.pluto.it/ildp}@* @w{ } @sp 9 -@ifclear SMALLPRINT @center @i{Ai miei genitori, per il loro amore, e per lo splendido esempio che mi hanno dato.} @sp 1 @center @i{A mia moglie, Miriam, per avermi reso completo. Grazie per aver costruito la tua vita insieme a me.} @sp 1 @center @i{Ai nostri figli, Chana, Rivka, Nachum e Malka, per aver arricchito le nostre vite in misura incalcolabile.} -@end ifclear - -@ifset SMALLPRINT -@center @i{Ai miei genitori, per il loro amore,} -@center @i{ e per lo splendido esempio che mi hanno dato.} -@sp 1 -@center @i{A mia moglie, Miriam, per avermi reso completo.} @* -@center @i{ Grazie per aver costruito la tua vita insieme a me.} -@sp 1 -@center @i{Ai nostri figli, Chana, Rivka, Nachum e Malka,} -@center @i{per aver arricchito le nostre vite in misura incalcolabile.} -@end ifset - @sp 1 @w{ } @page @@ -1308,17 +1289,9 @@ Ai nostri figli Chana, Rivka, Nachum e Malka, per aver arricchito le nostre vite in misura incalcolabile. @end ifinfo -@ifset SMALLPRINT -@fonttextsize 10 -@end ifset - @summarycontents @contents -@ifset SMALLPRINT -@fonttextsize 11 -@end ifset - @node Introduzione3 @unnumbered Introduzione alla Terza Edizione @@ -18509,12 +18482,7 @@ concettualmente, se i valori degli elementi sono 8, @code{"pippo"}, @ifnotdocbook @float Figura,vettore-elementi @caption{Un vettore contiguo} -@ifset SMALLPRINT -@center @image{gawk-vettore-elementi, 11cm, , Un vettore contiguo} -@end ifset -@ifclear SMALLPRINT @center @image{gawk-vettore-elementi, , , Un vettore contiguo} -@end ifclear @end float @end ifnotdocbook @@ -39222,13 +39190,7 @@ Questo si pu@`o vedere in @inlineraw{docbook, <xref linkend="figura-carica-esten @ifnotdocbook @float Figura,figura-carica-estensione @caption{Caricamento dell'estensione} -@ifclear SMALLPRINT @center @image{gawk-api-figura1, , , Caricamento dell'estensione} -@end ifclear -@ifset SMALLPRINT -@center @image{gawk-api-figura1, 11cm, , Caricamento dell'estensione} -@end ifset - @end float @end ifnotdocbook @@ -39263,12 +39225,7 @@ Questo @`e shown in @inlineraw{docbook, <xref linkend="figura-registrare-una-nuo @ifnotdocbook @float Figura,figura-registrare-una-nuova-funzione @caption{Registrare una nuova funzione} -@ifclear SMALLPRINT @center @image{gawk-api-figura2, , , Registrare una nuova funzione} -@end ifclear -@ifset SMALLPRINT -@center @image{gawk-api-figura2, 11cm , , Registrare una nuova funzione} -@end ifset @end float @end ifnotdocbook @@ -39303,12 +39260,7 @@ Questo @`e mostrato in @inlineraw{docbook, <xref linkend="figura-chiamata-nuova- @ifnotdocbook @float Figura,figura-chiamata-nuova-funzione @caption{Chiamata della nuova funzione} -@ifclear SMALLPRINT @center @image{gawk-api-figura3, , , Chiamata della nuova funzione} -@end ifclear -@ifset SMALLPRINT -@center @image{gawk-api-figura3,11cm , , Chiamata della nuova funzione} -@end ifset @end float @end ifnotdocbook @@ -41186,12 +41138,15 @@ in @multitable @columnfractions .50 .50 @headitem @tab Tipo di valore reale @end multitable +@ignore +@c 12/2023: Texinfo.tex has morphed enough that this produces +@c bad output, so comment it out. @c 10/2014: Thanks to Karl Berry for this bit to reduce the space: @tex \vglue-1.1\baselineskip @end tex +@end ignore @c @multitable @columnfractions .166 .166 .198 .15 .15 .166 -@ifclear SMALLPRINT @multitable {Richiesto} {Indefinito} {Numero} {Numero} {Scalare} {Regexp} {Numero} {Vettore} {Indefinito} @headitem @tab @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab Booleano @tab Vettore @tab Indefinito @item @tab @b{Stringa} @tab Stringa @tab Stringa @tab Stringa @tab Stringa @tab Stringa @tab false @tab false @@ -41204,24 +41159,6 @@ in @item @tab @b{Indefinito} @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab Booleano @tab Vettore @tab Indefinito @item @tab @b{@dfn{Value cookie}} @tab false @tab false @tab false @tab false @tab false @tab false @end multitable -@end ifclear - -@ifset SMALLPRINT -@smallformat -@multitable {Rich.} {Indef.} {Num.} {Num.} {Scal.} {Regex.} {Num.} {Vett.} {Indef.} -@headitem @tab @tab Str. @tab Strn. @tab Num. @tab Regex. @tab Bool. @tab Vett. @tab Indef. -@item @tab @b{Str.} @tab Str. @tab Str. @tab Str. @tab Str. @tab Str. @tab false @tab false -@item @tab @b{Strn.} @tab false @tab Strn. @tab Strn. @tab false @tab false @tab false @tab false -@item @tab @b{Num.} @tab Num. @tab Num. @tab Num. @tab false @tab Num. @tab false @tab false -@item @b{Tipo} @tab @b{Regex.} @tab false @tab false @tab false @tab Regex. @tab Bool. @tab false @tab false -@item @b{Rich.} @tab @b{Bool.} @tab false @tab false @tab false @tab false @tab Bool. @tab false @tab false -@item @tab @b{Vett.} @tab false @tab false @tab false @tab false @tab false @tab Vett. @tab false -@item @tab @b{Scal.} @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab false @tab false -@item @tab @b{Indef.} @tab Str. @tab Strn. @tab Num. @tab Regex. @tab Bool. @tab Vett. @tab Indef. -@item @tab @b{@dfn{Val. coo.}} @tab false @tab false @tab false @tab false @tab false @tab false -@end multitable -@end smallformat -@end ifset @end ifnotdocbook @end ifnotplaintext @ifplaintext @@ -41254,6 +41191,38 @@ in @end ifplaintext @end float +Ci sono alcune considerazioni di cui tener conto: + +@itemize @bullet +@item +Se si richiede il tipo @code{AWK_UNDEFINED}, la risposta @`e sempre +@dfn{true}, insieme al tipo effettivamente riscontrato per la +particolare variabile in questione. Si pu@`o considerare questo +caso come una specie di richiesta ``jolly''. + +@item +Se si richiede il tipo @code{AWK_STRING}, @command{gawk} converte +un valore scalare a una stringa, e questa @`e il valore restituito. + +@item +Se si richiede il tipo @code{AWK_NUMBER}, @command{gawk} converte +un valore scalare (tranne nel caso di una @dfn{regexp}, a un +valore numerico, e questo @`e il valore restituito. + +La conversione fra numero e stringa nelle funzioni API corrisponde +quindi al comportamento di @command{gawk} in un programma normale. + +@item +Le funzioni API @emph{non} fanno distinzione fra il tipo +@code{"undefined"} e il tipo @code{"unassigned"}, come restituiti +dalla funzione @code{typeof()} +(@pxref{Variabili di tipo dinamico in Gawk}). +In entrambi i casi viene restituito @code{AWK_UNDEFINED}. +@`E improbabile che questa differenza venga rimossa in futuro, +perch@'e la documentazione e il codice sorgente sono gi@`a +abbastanza complessi. +@end itemize + @node Accedere ai parametri @subsection Accedere ai parametri e aggiornarli @@ -41267,13 +41236,13 @@ passati all'estensione. Esse sono: Riempie la struttura @code{awk_value_t} puntata da @code{risultato} con l'argomento numero @code{count}. Restituisce @dfn{true} se il tipo dell'argomento corrisponde -a quello specificato in @code{wanted}, e @dfn{false} in caso contrario. +a quello specificato in @code{desiderato}, e @dfn{false} in caso contrario. In quest'ultimo caso, @code{risultato@w{->}val_type} indica il tipo effettivo dell'argomento (@pxref{table-value-types-returned}). La numerazione degli argomenti parte da zero: il primo argomento @`e il numero zero, il secondo @`e il numero uno, e cos@`{@dotless{i}} via. -@code{wanted} indica il tipo di valore atteso. +@code{desiderato} indica il tipo di valore atteso. @item awk_bool_t set_argument(size_t count, awk_array_t array); Converte un parametro di tipo indefinito in un vettore; ci@`o permette la @@ -41316,9 +41285,9 @@ Le funzioni sono le seguenti: Riempie la struttura @code{awk_value_t} puntata da @code{risultato} con il valore della variabile il cui nome @`e nella stringa @code{nome}, che @`e una normale stringa di caratteri C. -@code{wanted} indica il tipo di valore atteso. +@code{desiderato} indica il tipo di valore atteso. La funzione restituisce @dfn{true} se il tipo effettivo della variabile @`e quello -specificato in @code{wanted}, e @dfn{false} in caso contrario. +specificato in @code{desiderato}, e @dfn{false} in caso contrario. In quest'ultimo caso, @code{risultato>val_type} indica il tipo effettivo della variabile (@pxref{table-value-types-returned}). @@ -41758,8 +41727,8 @@ Restituisce @dfn{false} se si verifica un errore. @itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t *risultato); Per il vettore rappresentato da @code{a_cookie}, restituisce in @code{*risultato} il valore dell'elemento il cui indice @`e @code{index}. -@code{wanted} specifica il tipo di valore che si vuole ritrovare. -Restituisce @dfn{false} se @code{wanted} non coincide con il tipo di dato o +@code{desiderato} specifica il tipo di valore che si vuole ritrovare. +Restituisce @dfn{false} se @code{desiderato} non coincide con il tipo di dato o se @code{index} non @`e nel vettore (@pxref{table-value-types-returned}). Il valore per @code{index} pu@`o essere numerico, nel qual caso @command{gawk} @@ -48765,12 +48734,7 @@ Le persone che si occupano delle varie versioni di @command{gawk} sono: @cindex G., Daniel Richard @cindex Robbins @subentry Arnold @cindex Zaretskii, Eli -@ifset SMALLPRINT -@multitable {MS-Windows} {123456789012345678901234567890123456789001234567890} -@end ifset -@ifclear SMALLPRINT @multitable {MS-Windows con MinGW} {123456789012345678901234567890123456789001234567890} -@end ifclear @item Unix e sistemi POSIX @tab Arnold Robbins, @EMAIL{arnold@@skeeve.com,arnold (chiocciola) skeeve (punto) com} @item MS-Windows con MinGW @tab Eli Zaretskii, @EMAIL{eliz@@gnu.org,eliz (chiocciola) gnu (punto) org} @@ -50292,12 +50256,7 @@ Si veda la @inlineraw{docbook, <xref linkend="figura-generica-flusso"/>}. @ifnotdocbook @float Figura,figura-generica-flusso @caption{Flusso generico di un programma} -@ifclear SMALLPRINT @center @image{gawk-programma-generico, , , Flusso generico di un programma} -@end ifclear -@ifset SMALLPRINT -@center @image{gawk-programma-generico, 11cm, , Flusso generico di un programma} -@end ifset @end float @end ifnotdocbook @@ -50342,12 +50301,7 @@ come si vede nella @inlineraw{docbook, <xref linkend="figura-flusso-elaborazione @ifnotdocbook @float Figura,figura-flusso-elaborazione @caption{Fasi di un programma generico} -@ifclear SMALLPRINT @center @image{gawk-flusso-elaborazione, , , Fasi di un programma generico} -@end ifclear -@ifset SMALLPRINT -@center @image{gawk-flusso-elaborazione, 11cm , , Fasi di un programma generico} -@end ifset @end float @end ifnotdocbook |
