[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4646-g09b0538b
From: |
Antonio Giovanni Colombo |
Subject: |
[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4646-g09b0538b |
Date: |
Wed, 23 Feb 2022 04:32:19 -0500 (EST) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, feature/docit has been updated
via 09b0538bc7a237f690f178aae6a43f90dcb5c6dc (commit)
from f4e04f2a0da646b4d0ecda53d97d4743e941ab65 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=09b0538bc7a237f690f178aae6a43f90dcb5c6dc
commit 09b0538bc7a237f690f178aae6a43f90dcb5c6dc
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date: Wed Feb 23 10:30:39 2022 +0100
update to gawktexi.in readall and compatibility
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 56d87bf2..4c0c314a 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2022-02-23 Antonio Giovanni Colombo <azc100@gmail.com>
+
+ * gawktexi.in: Updated.
+
2022-02-10 Antonio Giovanni Colombo <azc100@gmail.com>
* gawktexi.in: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index af86524a..1a78b55c 100755
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -6440,12 +6440,13 @@ Quando @samp{@{} e @samp{@}} appaiono in costanti
@dfn{regexp}
in un modo non interpretabile come espressione di intervallo
(come in @code{/q@{a@}/}), allora sono prese letteralmente.
+@cindex Brian Kernighan @subsentry @command{awk} di @subentry espressioni di
intervallo in
Come detto sopra, le espressioni di intervallo non erano tradizionalmente
-disponibili in @command{awk}. Con la versione di Marzo 2019 di
+disponibili in @command{awk}. Con la versione di marzo 2019 di
BWK @command{awk} sono (finalmente) disponibili.
-Ciononostante, non essendo state disponibili per parecchi decenni,
-@command{gawk} continua a non renderle disponibili quando viene
-eseguito in modalit@`a compatibile (@pxref{Opzioni}).
+A partire dalla @value{PVERSION} 5.2 l'opzione @option{--traditional}
+di @command{gawk} non disabilita pi@`u le espressioni di intervallo
+contenute in espressioni regolari.
POSIX afferma che espressioni di intervallo che contengano
contatori di ripetizione maggiori di 255 producono risultati
@@ -7009,17 +7010,16 @@ Le espressioni di intervallo sono ammesse.
@cindex Brian Kernighan @subentry @command{awk} di
@item @option{--traditional}
Le @dfn{regexp} Unix tradizionali di @command{awk} sono ammesse. Gli
-operatori GNU non sono speciali, e le espressioni
-di intervallo non sono ammesse.
-Le classi di caratteri POSIX (@samp{[[:alnum:]]}, etc.) sono ammesse,
-poich@'e BWK @command{awk} le prevede.
+operatori GNU non sono speciali. Poich@'e sono supportate anche da
+BWK @command{awk},
+le classi di caratteri POSIX (@samp{[[:alnum:]]}, etc.) sono disponibili.
+Quindi, anche le espressioni di intervallo sono consentite.
I caratteri descritti usando sequenze di protezione ottali ed esadecimali sono
trattati letteralmente, anche se rappresentano metacaratteri di @dfn{regexp}.
@item @option{--re-interval}
-Sono consentite espressioni di intervallo in @dfn{regexp},
-se @option{--traditional} @`e stata specificata.
-Altrimenti, le espressioni di intervallo sono disponibili per default.
+Quest'opzione rimane specificabile per compatibilit@`a all'indietro,
+ma non ha in pratica alcun effetto.
@end table
@node Maiuscolo-Minuscolo
@@ -16620,7 +16620,7 @@ costituito da un unico carattere.
@cindex differenze tra @command{awk} e @command{gawk} @subentry variabile
@code{LINT}
@cindex @dfn{lint} @subentry controlli
@cindex controllo @subentry @dfn{lint}
-@item LINT o
+@item LINT #
Quando questa variabile @`e vera (non uguale a zero e non uguale alla stringa
nulla), @command{gawk} si comporta come se fosse stata specificata sulla
riga di comando l'opzione @option{--lint}
@@ -42232,8 +42232,9 @@ anche in questo caso @`e:
@node Esempio di estensione Rwarray
@subsection Scaricare e ricaricare un vettore
-L'estensione @code{rwarray} aggiunge due funzioni,
-di nome @code{writea()} e @code{reada()}, come segue:
+L'estensione @code{rwarray} aggiunge quattro funzioni,
+di nome @code{writea()}, @code{reada()},
+@code{writeall()} e @code{readall()}, come segue:
@table @code
@item @@load "rwarray"
@@ -42251,11 +42252,31 @@ valore uno se completa il lavoro o zero se non va a
buon fine.
@cindex estensione @subentry @code{reada()}
@item ret = reada(file, vettore)
@code{reada()} @`e la funzione inversa di @code{writea()};
-legge il file il cui nome @`e fornito come primo argomento, riempiendo il
+legge il file il cui nome @`e fornito come primo argomento, caricando il
vettore il cui nome @`e il secondo argomento. Il vettore viene preventivamente
svuotato.
-Anche in questo caso, il valore restituito @`e uno se tutto va bene o zero se
-la funzione non va a buon fine.
+Anche in questo caso, la funzione restituisce il valore uno se completa il
+il lavoro o zero se non va a buon fine.
+
+@cindex @code{writeall()} (estensione)
+@cindex estensione @subentry @code{writeall()}
+@item ret = writeall(file)
+Questa funzione ha come argomento una stringa, che @`e il nome del file
+sul quale scaricare tutte le variabili e i rispettivi valori.
+Chiamare questa funzione @`e completamente equivalente a chiamare
+@code{writea(file, SYMTAB)}. Restituisce il
+valore uno se completa il lavoro o zero se non va a buon fine.
+
+@cindex @code{readall()} (estensione)
+@cindex estensione @subentry @code{readall()}
+@item ret = readall(file)
+Questa funzione ha come argomento una stringa, che @`e il nome del file
+dal quale leggere i valori di molteplici variabili globali.
+Per ogni variabile contenuta nel file, il relativo valore viene
+caricato, a meno che la variabile sia gi@`a esistente.
+Se la variabile esiste gi@`a, il valore della variabile specificato
+nel file viene ignorato. Restituisce il
+valore uno se completa il lavoro o zero se non va a buon fine.
@end table
Il vettore creato da @code{reada()} @`e identico a quello scritto da
@@ -42279,6 +42300,16 @@ stringa possono essere scaricati da un sistema con un
certo ordine di byte
e ripristinati su un sistema con un ordine di byte differente, anche se
un test al riguardo non @`e mai stato fatto.
+Si noti che le funzioni @code{writeall()} e @code{readall()} forniscono
+un meccanismo che consente di ripristinare una situazione esistente
+nel caso in cui si chiami ripetutamente lo stesso programma.
+Se, per esempio, un programma calcola alcune statistiche basandosi sui
+dati contenuti in una serie di file, si potrebbe salvare lo stato delle
+variabili usando la funzione @code{writeall()} dopo aver elaborato
+N file, e in seguito ricaricare lo stato delle variabili usando la
+funzione @code{readall()} quando @`e disponibile il file N+1,
cos@`{@dotless{i}}
+da poter aggiornare i risultati.
+
Ecco un esempio:
@example
@@ -42287,6 +42318,10 @@ Ecco un esempio:
ret = writea("scaricato.bin", vettore)
@dots{}
ret = reada("scaricato.bin", vettore)
+@dots{}
+ret = writeall("situazione-corrente.bin")
+@dots{}
+ret = readall("situazione-corrente.bin")
@end example
@node Esempio di estensione Readfile
-----------------------------------------------------------------------
Summary of changes:
doc/it/ChangeLog | 4 ++++
doc/it/gawktexi.in | 69 ++++++++++++++++++++++++++++++++++++++++--------------
2 files changed, 56 insertions(+), 17 deletions(-)
hooks/post-receive
--
gawk
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4646-g09b0538b,
Antonio Giovanni Colombo <=